こんにちは!ともです。プログラミングや自動化を始めようとすると、最初に出てくるのが「エディタを用意しましょう」という話です。でも、エディタって何を選べばいいのか、入れたあと何を設定すればいいのか、最初は分からないことだらけですよね。
この記事では、エディタの定番であるVS Codeについて、インストールから日本語化、最初に入れる拡張機能、最低限の初期設定までを一気にまとめます。ここまで終われば、あとはコードを書き始めるだけの状態になります。
【この記事で分かること】

- VS Codeがどんな道具で、なぜ多くの作例で使われるのか
- WindowsとMacそれぞれのインストールの流れ
- 画面を日本語化する手順
- 最初に入れておくと便利な拡張機能
- 最低限やっておきたい初期設定と動作確認の方法
【VS Codeとは、コードを書くための無料のエディタ】

VS Code(Visual Studio Code)は、Microsoftが提供している無料のエディタです。エディタとは、プログラムの文章(コード)を書くための道具のことで、メモ帳の強化版のような存在だと考えてください。
普通のメモ帳と違うのは、コードを読みやすく色分けしてくれること、入力の途中で候補を出してくれること、間違いやすい場所を指摘してくれることなど、書く作業を助ける仕組みがそろっている点です。
このサイトの作例でも、コードを書く場面では基本的にVS Codeを使います。無料で使えて、WindowsでもMacでも同じ画面で作業できるため、解説と画面が食い違いにくいのが大きな理由です。
【必要なものとコスト】

用意するものは、パソコンとインターネット接続だけです。VS Code本体も、この記事で紹介する拡張機能も、すべて無料で使えます。
| 項目 | 内容 |
|---|---|
| 使うツール | VS Code(Visual Studio Code) |
| 料金の目安 | 無料(約0円) |
| 前提 | Windows 10以降、またはmacOSのパソコン/インターネット接続 |
【難易度と進め方の目安】

難易度は低めで、作業はインストールと設定のクリック操作が中心です。コードを書く場面は出てきません。目安の所要時間は、ダウンロードの速度にもよりますが30分前後です。
進め方は「インストール→日本語化→拡張機能→初期設定→動作確認」の順番です。この順番で進めると、途中で迷いにくくなります。
【手順1:VS Codeをインストールする】

まずは本体を入れます。大まかな流れは次のとおりです。
- VS Codeの公式サイト(code.visualstudio.com)を開く
- 自分のパソコン向けのダウンロードボタンを押す
- ダウンロードしたファイルを開いて、案内に沿って進める
- インストールが終わったら、VS Codeを起動する
Windowsの場合は、ダウンロードしたインストーラ(exeファイル)を実行し、案内画面を「次へ」で進めていけば完了します。途中で「追加タスクの選択」という画面が出たら、「PATHへの追加」にチェックが入っていることを確認してください。あとからコマンドでVS Codeを呼び出すときに必要になります。
Macの場合は、ダウンロードしたzipファイルを展開し、出てきた「Visual Studio Code」というアプリを「アプリケーション」フォルダへ移動します。そのあと、アプリケーションフォルダから起動すれば使えます。
【手順2:画面を日本語化する】

最初の起動では、メニューが英語で表示されます。英語のままでも使えますが、慣れるまでは日本語表示のほうが迷いません。日本語化は、拡張機能を1つ入れるだけで完了します。
- VS Codeの左側にある、ブロックのような形のアイコン(拡張機能)を押す
- 検索欄に「Japanese」と入力する
- 「Japanese Language Pack for Visual Studio Code」を選んで「Install」を押す
- 右下に再起動を促す案内が出たら、それを押して再起動する
再起動後にメニューが日本語になっていれば、日本語化は完了です。この「拡張機能を入れる」という操作は、この先も何度も使う基本操作なので、ここで覚えてしまいましょう。
【手順3:最初に入れる拡張機能】

拡張機能は、VS Codeに機能を足すための追加部品です。入れすぎると管理が大変になるので、最初は次の3つくらいで十分です。入れ方は日本語化のときと同じで、拡張機能の画面で名前を検索して「インストール」を押します。
| 拡張機能 | 役割 |
|---|---|
| Japanese Language Pack | 画面を日本語表示にする(手順2で導入済み) |
| Python | Pythonのコードを書くときの入力補助や間違いの指摘 |
| Prettier | コードの見た目(改行や字下げ)を自動で整える |
Pythonの拡張機能は、このサイトのPython作例を進めるうえでほぼ必須です。Node.jsやDifyなど、別の道具の作例を進めるときに必要なものは、その記事の中で都度案内します。
なお、拡張機能は作った人によって品質に差があります。名前が似ているものも多いので、提供元がMicrosoftなど信頼できる相手かどうかを確認してから入れるのが安全です。
【手順4:最低限の初期設定】

最後に、設定画面で次の2つだけ確認しておくと、この先の作業が楽になります。設定画面は、左下の歯車アイコンから「設定」を選ぶと開きます。
1つ目は「自動保存」です。検索欄に「auto save」と入力し、「Files: Auto Save」を「afterDelay」に変えておくと、書いたコードが自動で保存されるようになります。保存し忘れて「動かない」と悩む事故が減ります。
2つ目は「文字の大きさ」です。「Font Size」で、コードの文字サイズを自分の見やすい大きさに調整します。最初は14〜16くらいが目安です。設定は入力した瞬間に反映されるので、画面を見ながら調整できます。
【作業フォルダの置き場所を決めておく】

初期設定とあわせて、コードを置く場所も決めておきましょう。デスクトップやダウンロードフォルダに散らかしておくと、あとで「あの作例はどこに置いたか」が分からなくなります。
おすすめは、自分のユーザーフォルダの中に「projects」のような親フォルダを1つ作り、作例ごとにその中へフォルダを分ける形です。VS Codeでフォルダを開くときも、この親フォルダを起点に探せるので迷いません。
置き場所のルールは、最初に決めるほど効果があります。作例が増えてから整理し直すのは大変なので、このタイミングで決めておきましょう。
【動作確認:ファイルを作って開いてみる】

設定が終わったら、実際に動くか確かめましょう。次の流れで、簡単なファイルを作って開いてみます。
- デスクトップなどに「test」という名前のフォルダを作る
- VS Codeの「ファイル」→「フォルダーを開く」で、そのフォルダを選ぶ
- 左側のファイル一覧の上で「新しいファイル」を押し、「hello.txt」と名前を付ける
- 何か文字を入力して、自動保存が効いているか(ファイル名の横の印が変わるか)を確認する
フォルダを開いて、ファイルを作って、文字が保存されるところまで確認できれば、VS Codeの初期設定は完了です。この「フォルダを開いて作業する」という形が、作例を進めるときの基本形になります。
【つまずきやすい点】

よくあるつまずきは3つです。1つ目は、ダウンロードのときに自分のパソコンと違う種類のファイルを選んでしまうことです。WindowsならWindows版、MacならMac版を選んでください。Macの場合は、チップの種類(AppleシリコンかIntelか)でファイルが分かれていることもあります。
2つ目は、日本語化したのに画面が英語のまま変わらないことです。多くの場合、再起動が済んでいないのが原因です。いったんVS Codeを完全に終了して、もう一度起動してみてください。
3つ目は、拡張機能を入れすぎることです。便利そうに見えるものを片っ端から入れると、動作が重くなったり、設定同士がぶつかったりします。最初は必要最低限にして、作例ごとに必要なものを足していく進め方がおすすめです。
【まとめ】

VS Codeは、コードを書くための無料のエディタです。インストール、日本語化、拡張機能、初期設定、動作確認という流れで進めれば、30分前後で書き始める準備が整います。
環境全体の考え方から確認したい場合は、先に全体像の記事を読んでおくと、この記事の位置づけがつかみやすくなります。
次の一歩としては、変更の記録を残すための道具であるGitを入れるのがおすすめです。コードを書き始める前に記録の仕組みを用意しておくと、あとで「前の状態に戻したい」というときに困りません。
なお、「自分で作るのではなく、業務の自動化そのものを相談したい」という場合は、作ってもらう選択肢もあります。
\ 業務の自動化やAI活用を、代わりに作ってほしい方はこちら /


コメント