C言語の開発環境の構築方法（WSL, Ubuntuインストールもついでに） Qiita Ver.

皆さんこんにちは、<font color="blue">紫夜千景</font>です。

この記事は、かつて **「紫夜千景の雑記」** で投稿していた

https://shiyachikagenozakki.blogspot.com/2025/02/ubuntu.html

という記事をQiitaで分かりやすくした改良版です。

基本的な内容は同じですが、こちらの方が分かりやすくまとまっているような気がするのでQiitaでも良いという方はこちらをご覧ください。

# WindowsのWSLの機能を有効化と準備
まず最初に、WindowsにWSLを用いてUbuntuを導入するために

**「Windowsの機能の有効化または無効化」** より
**・「<font color="#00FFFF">Linux用Windowsサブシステム</font>」**
**・「<font color="#00FFFF">仮想マシンプラットフォーム</font>」**

の2つの機能を有効にします。

**「Windowsの機能の有効化または無効化」** は、タスクバーの検索欄に入力すると出てきます。

この作業には<font color="red">管理者権限</font>が必要になりますので注意してください。

**「仮想マシンプラットフォーム」** の項目が見つからない場合、下の画像のように
「<font color="#00FFFF">Virtual Machine Platform</font>」のように英語になっている可能性があるので注意しましょう。

**「Linux用Windowsサブシステム」** も同様に
「<font color="#00FFFF">Windows Subsystem for Linux</font>」と英語で表示される可能性があるのでしっかり確認しましょう。

![スクリーンショット 2025-02-04 112034.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/be7059dc-ecd9-4ab1-b961-d2daceed960d.png)

![スクリーンショット 2025-02-04 112052.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/faaa5f92-79e3-4eaa-bfbf-3f998338e10c.png)

上記の画像を参考に、2つの項目にチェックを入れてください。
この機能を有効化せずともUbuntuのインストールは可能ですが、動作しないのでちゃんとこの機能を有効化しましょう。

有効化しないとどうなるのか、復旧方法は以下の記事をご覧ください。

https://shiyachikagenozakki.blogspot.com/2025/02/wslubuntu.html

この2つの項目にチェックを入れるとパソコンを再起動するように言われるので、再起動しましょう。
すると機能が有効化されます。

パソコンの再起動後、既にWSLは使える状態になっていますがWSLのLinuxカーネルを更新する必要があります。

そのため、Windows PowerShellを起動し
`wsl --update`
を実行してください。
![スクリーンショット 2025-02-17 111758.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/c4155362-c95e-48e2-bb8e-b649be5df1f8.png)

この作業にも<font color="red">管理者権限</font>が必要になってくるので注意しましょう。



もしくは、[Microsoftのページ](https://learn.microsoft.com/ja-jp/windows/wsl/install-manual#step-4---download-the-linux-kernel-update-package)から
**`wsl_update_x64.msi`** をダウンロードして管理者権限で実行することでもアップデートは可能です。
![スクリーンショット 2025-02-17 113346.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/4ec68783-0be6-4290-a115-c050fb9b3101.png)

これでWSLの準備は完了です。

# Ubuntuのインストール、初期設定

次に、[Microsoft Storeのページ](https://apps.microsoft.com/detail/9pdxgncfsczv?hl=ja-jp&gl=JP)からUbuntuをインストール・初期設定していきます。

![スクリーンショット 2025-02-21 222249.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/35e4be30-79a5-4ec2-aea6-dd280ef8c3f3.png)

インストールが終わり、Ubuntuを起動すると
![スクリーンショット 2025-02-17 130552.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/14561b7f-f340-44a6-8050-a58221241585.png)

ユーザーを登録する画面が表示されます。
この画面を表示させるために[異なるOS](https://www.kali.org/)を使ったので少しUbuntuのものと少し違いますが、ユーザー名を入力するところは一緒なので気にしないでください。

ユーザー名を入力するように言われるので入力してください。
ここはPCのユーザー名と異なっていても問題ありません。

ここでは不具合を避けるため、ユーザー名に日本語を含まないようにしましょう。


ユーザー名を入力すると、次はパスワードを入力するように言われるので入力してください。
![スクリーンショット 2025-02-17 130612.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/07e79ffe-bab0-4e18-abfc-d5c683e4851f.png)

ここもPCのパスワードと同じにする必要はありませんが、重要なのでここで入力したパスワードをちゃんと覚えておきましょう。



パスワードを入力する際、入力したパスワードは表示されないので注意しましょう。

確認のためもう一度パスワードを入力して、ユーザー名が **<font color="green">緑色の文字</font>** で表示されればユーザー設定は完了です。

ちゃんとユーザー設定が完了した場合、次の手順は飛ばしてください。



またここで何らかのエラーによりユーザー登録が完了しなかったり、このユーザー設定の手順を飛ばしてユーザー名が **<font color="white">白色の文字</font>** で表示される場合は別でユーザー設定が必要になるので次の手順で作業を行ってください。

# ユーザー登録が上手にいかなかった場合の対処法

最初にユーザー名が白色の文字のままターミナルで
`adduser chikage-kali`
と入力し、ユーザーを新規作成します。
![スクリーンショット 2025-02-17 132610.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/63688103-445b-4053-b653-b96b085fc8d3.png)

adduserの後の `chikage-kali` は自身が設定したいユーザー名に置き換えてください。

ここでもパスワード設定が必要になるので、先ほどのパスワード設定と同じように設定してください。

その後、
`sudo gpasswd -a 設定したユーザー名 sudo` 
を実行して、先ほど作ったユーザーに **sudo権限（管理者権限）** を与えます。
![スクリーンショット 2025-02-17 132703.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/887185a1-c4ba-42ac-a031-41bd5408f2d5.png)

ここの `先ほど作ったユーザー名` は先ほど作ったユーザー名を入力してください。

完了したら、一旦Ubuntuを閉じます。

最後に、**WindowsのPowerShell上** で
`ubuntu config --default-user 先ほど作ったユーザー名`
を入力して、デフォルトで先ほど作ったユーザーで起動するように設定します。
![スクリーンショット 2025-02-17 133607.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/8edcac7b-e6fd-4bdb-a267-8472ad991692.png)



ここも `先ほど作ったユーザー名` は任意のものに変更してください。



この後、Ubuntuを起動してユーザー名が **<font color="green">緑色の文字</font>** で表示されていれば作業は完了です。


# Ubuntuのパッケージのアップデート、インストール

ユーザーの設定が終わったら、次はパッケージのアップデート及びインストールを行っていきます。
と言っても、パッケージのアップデートは

`sudo apt update && sudo apt full-upgrade -y`


というコマンド1つで実行できます。

このコマンドは `sudo` と呼ばれるWindowsでいう<font color="red">管理者権限</font>を使っているのでユーザーのパスワードを要求されます。
![スクリーンショット 2025-06-13 133223.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/aeba8462-f80c-4ccc-b1dc-1f30682cf36d.png)

この時、パスワードを入力しても画面には出力されないので注意しましょう。
間違えても数回は再入力ができたはずなので慌てず落ち着いて入力しましょう。

![スクリーンショット 2025-06-13 133312.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/c0f32eba-16c9-4c5d-b170-c864554a5726.png)

ちゃんとパスワードが入力できていると上記の画像のようにズラーと文字がたくさん出てきます。
少し時間がたってターミナルが入力を受け付ける状態になったらアップデート終了です。

次にC言語のプログラム実行に必要なパッケージをインストールしていきます。

ターミナルで

`sudo apt install gdb`

`sudo apt install gcc`

の2つを実行します。
こちらも `sudo` を使っているのでパスワードを要求されますので先ほど同様入力しましょう。

するとまたズラーと文字が流れてターミナルが入力を受け付けるようになったら
**`gdb -v`**
![スクリーンショット 2025-02-18 085339.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/50234eab-7ab2-4c82-9573-48447fa600d8.png)


**`gcc -v`**
![スクリーンショット 2025-02-18 085745.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/a38fd6b1-f3d3-4182-bc5f-0abb6892e8d2.png)

を実行してgdbとgccが正しくインストールされているかをチェックします。
上記の画像のように出てくれば成功です。

お次で最後ですが、次の項目からUbuntuでの作業ではなくWindowsでの作業になります。

# VSCode・拡張機能のインストール

Windowsで、[Microsoft Store](ms-windows-store://pdp?hl=ja-jp&gl=jp&referrer=storeforweb&source=https%3A%2F%2Fwww.google.com%2F&ocid=sfw-fab-treatment&productid=xp9khm4bk9fz7q&mode=full&storecid=sfw-secondary-cta&webid=ef5b2973-1bc7-42d0-a84d-cfa37886caec&websessionid=02374888-df68-40c7-bbe7-2e683a35d0bc)や[公式ホームページ](https://code.visualstudio.com/)から **「Visual Studio Code」**
通称 **「VSCode」** と呼ばれるソフトをダウンロード・インストールします。

![スクリーンショット 2025-02-17 134549.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/8df375ad-2a80-42dc-891a-d9ccfa2cba4f.png)


こちらのソフトは、簡単に言うとプログラムを書くためのコードエディターのソフトになります。



公式ホームページからダウンロードされた方はダウンロードしたファイルを実行してVSCodeをインストールします。

いくつか設定についての質問がありますが、基本的にインストールさえできればOKなのでお好きなように設定していただければと思います。



インストールが完了し、VSCodeを実行すると、このような画面が表示されます。
![スクリーンショット 2025-02-17 135408.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/38d53d60-c627-4329-b70f-4a5ce1b595cc.png)




VSCodeが開いたら、左側にある拡張機能アイコンをクリックして以下の拡張機能をダウンロードしていきます。

![スクリーンショット 2025-02-18 093235.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/70f4ea17-ccdb-4350-82e0-0cec712d531a.png)
↑これ

**・WSL**
![スクリーンショット 2025-02-18 092907.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/ec82356f-1f86-4a13-83cf-f459a1e87026.png)



WSLのインストールが終わりましたら、左下の

![スクリーンショット 2025-02-18 092522.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/75a10e3a-38e6-4871-84d4-c33b73981cf2.png)

アイコンをクリックしてください。すると検索バーの方に

![スクリーンショット 2025-02-18 092452.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/ba942ab6-3324-476e-bd82-238b15d040ed.png)

**「WSLへの接続」** と表示されるのでそちらをクリックしてください。

英語で「New WSL Window」と表示されることもありますが、機能的には一緒なのでそちらをクリックしてください。

すると、VSCodeが再読み込みされたのち左下の表示が
![スクリーンショット 2025-02-18 092443.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/e147298f-7d2c-472c-a0c3-52fd72452b63.png)


と切り替わっていたらWSLへの接続が完了しました。



完了したら、先ほどと同じように下記の機能をインストールしてください。


Japanese Language Pack for Visual Studio Code（検索欄にjapaneseって打ち込めば出てきます。）
![スクリーンショット 2025-02-18 092846.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/0b4367d7-1e5b-4cf8-868b-f8c501b20cf1.png)

C/C++
![スクリーンショット 2025-02-18 092821.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/c69a637f-4fea-421f-8efa-06d0b496ed39.png)

C/C++ Themes
![スクリーンショット 2025-02-18 092840.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/131972ef-9c7b-4f1b-bb4a-519c05ddca34.png)

C/C++ Extension Pack
![スクリーンショット 2025-02-18 092756.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/d06aa132-afc5-44b2-87a4-4e3a687b7a19.png)

CMake
![スクリーンショット 2025-02-18 092827.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/ff5c3b99-6aaf-409e-83fe-9a38759bf6b0.png)

CMake Tools
![スクリーンショット 2025-02-18 092832.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/5b36d3e2-7930-4ff1-b160-52bf8f91443a.png)


これらをすべてインストールしたら、VSCodeを再起動します。

それで、左下の表示が「WSL: Ubuntu」になっていたらVSCodeの設定は完了です。
![スクリーンショット 2025-02-18 092443.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/133d4232-7151-45f9-a250-ab0f493b3364.png)

もしかすると何らかの原因で接続されていない場合もありますが、その時は再びWSLへの接続を行ってください。

最後にきちんと動作するか、下記のコードをVSCodeで入力して実行してみましょう。
```C
#include <stdio.h>
int main(void)
{
    printf("Hello, World!\n");
}
```

これらを入力して一度保存しましょう。**Ctrl+S** で保存でき、名前を設定して完了です。
保存したプログラムを実行するには、**Ctrl+F5** もしくは右上にある
![スクリーンショット 2025-02-18 101322.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/d9860f44-a4dc-46f8-9d52-e33369725e36.png)

を押すと



と検索バーのところに表示されるので一番上のものをクリックしましょう。
![スクリーンショット 2025-02-18 101155.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/a166f39e-6523-4253-acd0-658c75bd42b2.png)

すると、画面下にあるターミナルで実行されて結果が反映されます。
![スクリーンショット 2025-06-16 153310.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4108762/7de671b9-de55-4c9f-b047-67da24bba63f.png)

ちゃんとターミナルに結果が出力されていますね。

これでC言語の開発環境の構築の工程が全て完了しました。



お疲れさまでした。






ここはおまけみたいな感じですが、実はサンプルプログラムのところ昔[Bloggerで公開](https://shiyachikagenozakki.blogspot.com/2025/02/ubuntu.html)したところは簡単な計算プログラムだったんですが、当時公開した後に友人から
**「サンプルプログラムならHello Worldを出力させるプログラムの方が良いんじゃない？」**
と言われたのでQiitaの方ではHello Worldを出力するプログラムになっています。


いつかBloggerの方で出してたWSLのUbuntuを外部ツールを用いてGUI化する記事も時間があったらQiitaにする予定です。