Visual Studio Code のダウンロード、インストール、日本語化と、Python プログラムの実行(Windows 上)
【概要】
高機能なコードエディタである Visual Studio Code (VS Code) を Windows 環境にインストールし、日本語化を行い、Python および C 言語の開発が行えるように基本的な設定を行う手順を説明する。
【その他情報】
実演ビデオ(YouTube)「Visual Studio Code のインストール(Windows 上)」: https://www.youtube.com/watch?v=2SVnOoJg4JY
実演ビデオ(YouTube)「Visual Studio Code で Python を使う」: https://www.youtube.com/watch?v=B2QB8gvk11g
【目次】
- Visual Studio Code のダウンロードとインストール
- Visual Studio Code の日本語化
- Python 開発環境のセットアップ
- C 言語プログラムの編集と C/C++ 拡張機能
- その他の便利な拡張機能
【関連する外部ページ】
- Visual Studio Code の公式ダウンロードページ: https://code.visualstudio.com/Download
- Visual Studio Code の公式ページ: https://code.visualstudio.com/
【サイト内の関連情報】
- Windows での Visual Studio Code のインストール、設定: 別ページ »で説明
- Visual Studio Code で Python プログラミング(Windows 上)
- Python のステップ実行、オブジェクトをビジュアルに観察(Visual Studio Code の Python Preview を使用)
Visual Studio Code
Visual Studio Code は、拡張性の高いテキストエディタである。多様なプログラミング言語に対応し、ソースコードのシンタックスハイライト、コード補完 (IntelliSense)、デバッグ機能の統合、Git 連携など、ソースコードの編集やデバッグを効率的に行う機能を備える。
winget を用いたインストールコマンド: winget install --scope machine --id Microsoft.VisualStudioCode -e
Visual Studio Code のダウンロードとインストール
まず、Visual Studio Code 本体を公式サイトからダウンロードし、インストールする。
- ウェブブラウザで以下の URL を開く。
- 「Windows」版をダウンロードする。
- ダウンロードされた
.exeファイルを実行する。
- 内容を確認し、同意できる場合は「同意する」を選択して「次へ」をクリックする。
- 通常は変更の必要がないため、既定(デフォルト)のままで「次へ」をクリックする。
- そのまま「次へ」をクリックする。
- 必要に応じて、「PATH への追加」や「エクスプローラーのコンテキストメニューに追加」などのオプションを確認・選択し、「次へ」をクリックする(通常はデフォルトでも問題ない)。
- 「インストール」をクリックすると、インストールが開始される。
- インストール完了画面が表示されたら、「完了」をクリックする。
- インストールが正常に完了したか確認するため、一度 Visual Studio Code を起動してみる。
Visual Studio Code の日本語化
デフォルトでは英語表示のため、必要に応じて日本語化を行う。これには「Japanese Language Pack」拡張機能を使用する。
- Visual Studio Code を起動する。
- 左側のアクティビティバーから「拡張機能」 (Extensions) アイコン(四角いブロックのアイコン)をクリックするか、「表示 (View)」 > 「拡張機能 (Extensions)」を選択する。
- 検索ボックスに「japanese」と入力する。
- 「Japanese Language Pack for Visual Studio Code」が表示されたら、「Install」ボタンをクリックする。
- インストール後、右下に表示される「Change Language and Restart」をクリックするか、以下の手順で言語を変更する。
Ctrl+Shift+Pを押してコマンドパレットを開く。Configure Display Languageと入力し、表示されたコマンドを実行する。
- 表示された言語リストから「ja」 (日本語) を選択する。
- Visual Studio Code の再起動を促す表示が出るので、「Restart」をクリックする。再起動後、インターフェースが日本語表示になる。
Python 開発環境のセットアップ
Python 3.12 のインストール
Pythonのインストールを行い、Pythonのプログラムを実行する環境を整える。扱う環境は、Windows搭載パソコンである。金子研究室では、Python 3.12.10を推奨する。
[Windows での Python 3.12 のインストール手順を見るには、ここをクリック]
Windows での Python 3.12 のインストール
以下のいずれかの方法でPython 3.12をインストールする。Pythonがインストール済みの場合、この手順は不要である。
方法 1:winget によるインストール
【インストールコマンドの実行方法】
管理者権限でコマンドプロンプトを起動する(手順:Windowsキーまたはスタートメニュー → cmd と入力 → 右クリック → 「管理者として実行」)。そして、コマンド全体をコマンドプロンプトにコピー&ペーストする。
--scope machine を指定することで、システム全体(全ユーザー向け)にインストールされる。このオプションの実行には管理者権限が必要である。インストール完了後、コマンドプロンプトを再起動するとPATHが反映される。
REM Python 3.12 をシステム領域にインストール
winget install --id Python.Python.3.12 -e --scope machine --silent --accept-source-agreements --accept-package-agreements --override "/quiet InstallAllUsers=1 PrependPath=1 Include_test=0 Include_pip=1 Include_launcher=1 InstallLauncherAllUsers=1 TargetDir=\"C:\Program Files\Python312\""
REM Python と Scripts を PATH 先頭に追加
powershell -NoProfile -Command "$p='C:\Program Files\Python312'; $s=\"$p\Scripts\"; $c=[Environment]::GetEnvironmentVariable('Path','Machine'); if((Test-Path $p) -and (';'+$c+';' -notlike \"*;$p;*\") -and (';'+$c+';' -notlike \"*;$s;*\")){[Environment]::SetEnvironmentVariable('Path',\"$p;$s;$c\",'Machine')}"
方法 2:インストーラーによるインストール
- Python公式サイト(https://www.python.org/downloads/)にアクセスし、「Download Python 3.x.x」ボタンからWindows用インストーラーをダウンロードする。
- ダウンロードしたインストーラーを実行する。
- 初期画面の下部に表示される「Add python.exe to PATH」にチェックを入れてから「Customize installation」を選択する。このチェックを入れ忘れると、コマンドプロンプトから
pythonコマンドを実行できない。 - 「Install Python 3.xx for all users」にチェックを入れ、「Install」をクリックする。
インストールの確認
コマンドプロンプトで以下を実行する。
python --version
バージョン番号(例:Python 3.12.x)が表示されればインストール成功である。「'python' は、内部コマンドまたは外部コマンドとして認識されていません。」と表示される場合は、インストールが正常に完了していない。
VS Code Python 拡張機能のインストール
VS Code で Python を開発するために、Microsoft 提供の公式 Python 拡張機能をインストールする。これにより、コード補完 (IntelliSense)、デバッグ、リンティング(コードの誤りや書き方の問題の指摘)などの機能が利用可能になる。コード補完を担う Pylance も、この拡張機能とともに導入される。
- VS Code の左側のアクティビティバーから「拡張機能」アイコンをクリックする。
- 検索ボックスに
Pythonと入力する。 - Microsoft によって発行されている「Python」拡張機能 (通常、一番上に表示される) を選択し、「インストール」ボタンをクリックする。
Python プログラムの編集と実行
Python 拡張機能をインストールしたら、実際に Python ファイルを作成し、実行してみる。
- 「ファイル (File)」 > 「新規ファイル (New File)」を選択する。
- 新しいエディタ画面(中身は空)が開くことを確認する。
- 「ファイル (File)」 > 「名前を付けて保存 (Save As...)」を選択し、ファイル名に
.pyの拡張子 (例:hello.py) を付けて保存する。
- 保存するディレクトリ(フォルダ)を指定する。すでに同一名のファイルが存在する場合は確認が表示される。
.pyファイルを初めて開くと、リンター (Pylint など) やフォーマッター (Black など) の追加の拡張機能のインストールを推奨される場合がある。これらはコードの品質向上に役立つため、必要に応じてインストールする。- エディタ画面に、簡単な Python プログラムを入力する。
print("Hello, World!")
- エディタ右上の「実行 (Run)」ボタン (緑色の三角アイコン ▷) をクリックする。これにより、現在 VS Code で選択されている Python インタープリターを使ってスクリプトが実行される。
- 画面下部の「ターミナル」パネルに
Hello, World!と表示されることを確認する。
- 複数の Python 環境がシステムに存在する場合、VS Code ウィンドウ右下のステータスバーに表示されている Python のバージョン (例:
Python 3.12.1 64-bit) をクリックすることで、使用するインタープリターを切り替えることができる。
Python デバッガの使用
VS Code の Python 拡張機能には、デバッグ機能が含まれている。ここでは基本的な使い方を紹介する(Python 拡張機能がインストールされていることが前提である)。
-
エディタ画面で、プログラムの実行を一時停止したい行の左側の行番号のさらに左をクリックすると、赤い丸 (ブレークポイント) が表示される。再度クリックすると解除される。
-
「実行 (Run)」 > 「デバッグの開始 (Start Debugging)」を選択するか、
F5キーを押す。
初めてデバッグを実行する場合、デバッグ構成を選択するよう求められることがある。通常は「Python ファイル (Python File)」を選択する。
プログラムが実行され、設定したブレークポイントで停止する。停止すると、左側の「実行とデバッグ」 (Run and Debug) ビューで変数の中身などを確認できる。
-
プログラムを一行ずつ実行する。関数呼び出しがある場合は、その関数の中に入る。「実行 (Run)」 > 「ステップイン (Step Into)」を選択するか、画面上部のデバッグツールバーの「ステップイン」アイコンをクリックするか、
F11キーを押す。
-
次のブレークポイントまで、またはプログラムの終わりまで実行を再開する。「実行 (Run)」 > 「続行 (Continue)」を選択するか、画面上部のデバッグツールバーの「続行」アイコンをクリックするか、
F5キーを押す。
C 言語プログラムの編集と C/C++ 拡張機能
VS Code は C 言語のプログラム編集にも適している。ここでは基本的なファイル作成と、開発を助ける C/C++ 拡張機能について説明する。
- Visual Studio Code を起動する。
- 「ファイル (File)」 > 「新規ファイル (New File)」を選択する。
- 新しいエディタ画面(中身は空)が開くことを確認する。
- 「ファイル (File)」 > 「名前を付けて保存 (Save As...)」を選択し、ファイル名に
.cの拡張子 (例:main.c) を付けて保存する。 - 保存するディレクトリ(フォルダ)を指定する。すでに同一名のファイルが存在する場合は確認が表示される。
-
.cファイルを初めて開くと、「C/C++ Extension Pack」のインストールを推奨されることがある。これは Microsoft 提供の拡張機能で、C/C++ のコード補完 (IntelliSense)、デバッグ、コードナビゲーションなどを強化する。インストールを推奨する。推奨されなかった場合や後でインストールする場合は、拡張機能ビューで
C/C++と検索し、Microsoft 提供のものをインストールする。
- エディタ画面に、簡単な C プログラムを入力する。
#include <stdio.h> #include <stddef.h> // size_t を使うために追加 int main() { printf("Hello, World!\n"); printf("sizeof(size_t) = %zu\n", sizeof(size_t)); return 0; }
-
VS Code は C 言語のコードエディタおよびデバッガのインターフェースであるが、C プログラムのコンパイル(実行可能ファイルの生成)と実行には、別途 C コンパイラ (例: MSVC の cl、GCC、Clang) がシステムにインストールされている必要がある。
コンパイラがインストールされていれば、VS Code のターミナルから
gcc main.c -o mainのようなコマンドでコンパイルし、./mainで実行できる。より高度なビルドやデバッグ設定については、VS Code の
tasks.jsonやlaunch.jsonファイルの設定が必要になる(この記事の範囲外)。
その他の便利な拡張機能
VS Code は拡張機能でカスタマイズできる。拡張機能ビュー (Ctrl+Shift+X) や以下のマーケットプレイスで探すことができる。
Visual Studio Marketplace: https://marketplace.visualstudio.com/
- Python 関係:
- Python:Microsoft 提供の Python 開発支援機能。
- Pylance:Microsoft 提供の言語サーバ。コード補完 (IntelliSense) を担う。
- Python Indent:Python のインデントを自動調整・支援する。
- Python Preview:Python プログラムをステップ実行し、オブジェクト(変数とその値)をビジュアルに観察する。
- C/C++ 関係:
- C/C++:Microsoft 提供の C/C++ 開発支援機能パック。
- C/C++ Themes:C/C++ コードのシンタックスハイライトテーマ。
- Java 関係:
- Extension Pack for Java:Java 開発に必要な拡張機能パック。
- Debugger for Java:Java 用のデバッガ。
- WSL 関係:
- WSL:Windows Subsystem for Linux (WSL) 内のプロジェクトを直接 VS Code で開いて編集・デバッグできる。
- キーバインド:
- Emacs キーバインド: Emacs Friendly Keymap:Emacs のキーバインドを VS Code で利用可能にする。
- 同様に、Vim など他のエディタのキーマップ拡張機能も存在する。