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 は、拡張性の高いテキストエディタである。多様なプログラミング言語に対応し、ソースコードのシンタックスハイライト、コード補完 (IntelliSense)、デバッグ機能の統合、Git 連携など、ソースコードの編集やデバッグを効率的に行う機能を備える。

winget を用いたインストールコマンド: winget install --scope machine --id Microsoft.VisualStudioCode -e

Visual Studio Code のダウンロードとインストール

まず、Visual Studio Code 本体を公式サイトからダウンロードし、インストールする。

  1. ウェブブラウザで以下の URL を開く。

    https://code.visualstudio.com/Download

  2. 「Windows」版をダウンロードする。
    Visual Studio Code の公式ダウンロードページ
    Visual Studio Code のダウンロードボタン
  3. ダウンロードされた .exe ファイルを実行する。
    ダウンロードされたインストーラーファイル
    インストーラーのアイコン
  4. 内容を確認し、同意できる場合は「同意する」を選択して「次へ」をクリックする。
    使用許諾契約の画面
  5. 通常は変更の必要がないため、既定(デフォルト)のままで「次へ」をクリックする。
    インストール先の選択画面
  6. そのまま「次へ」をクリックする。
    プログラムグループの選択画面
  7. 必要に応じて、「PATH への追加」や「エクスプローラーのコンテキストメニューに追加」などのオプションを確認・選択し、「次へ」をクリックする(通常はデフォルトでも問題ない)。
    追加タスクの選択画面
  8. 「インストール」をクリックすると、インストールが開始される。
    インストール準備完了の画面
    インストール進行中の画面
  9. インストール完了画面が表示されたら、「完了」をクリックする。
    インストール完了の画面
  10. インストールが正常に完了したか確認するため、一度 Visual Studio Code を起動してみる。
    Visual Studio Code の起動画面

Visual Studio Code の日本語化

デフォルトでは英語表示のため、必要に応じて日本語化を行う。これには「Japanese Language Pack」拡張機能を使用する。

  1. Visual Studio Code を起動する。
  2. 左側のアクティビティバーから「拡張機能」 (Extensions) アイコン(四角いブロックのアイコン)をクリックするか、「表示 (View)」 > 「拡張機能 (Extensions)」を選択する。
    拡張機能アイコンの位置
  3. 検索ボックスに「japanese」と入力する。
  4. 「Japanese Language Pack for Visual Studio Code」が表示されたら、「Install」ボタンをクリックする。
    Japanese Language Pack の検索結果
  5. インストール後、右下に表示される「Change Language and Restart」をクリックするか、以下の手順で言語を変更する。
    • Ctrl+Shift+P を押してコマンドパレットを開く。
    • Configure Display Language と入力し、表示されたコマンドを実行する。
    コマンドパレットの表示
    Configure Display Language コマンド
  6. 表示された言語リストから「ja」 (日本語) を選択する。
    言語選択画面
  7. 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:インストーラーによるインストール

  1. Python公式サイト(https://www.python.org/downloads/)にアクセスし、「Download Python 3.x.x」ボタンからWindows用インストーラーをダウンロードする。
  2. ダウンロードしたインストーラーを実行する。
  3. 初期画面の下部に表示される「Add python.exe to PATH」にチェックを入れてから「Customize installation」を選択する。このチェックを入れ忘れると、コマンドプロンプトから python コマンドを実行できない。
  4. 「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 も、この拡張機能とともに導入される。

  1. VS Code の左側のアクティビティバーから「拡張機能」アイコンをクリックする。
  2. 検索ボックスに Python と入力する。
  3. Microsoft によって発行されている「Python」拡張機能 (通常、一番上に表示される) を選択し、「インストール」ボタンをクリックする。

Python プログラムの編集と実行

Python 拡張機能をインストールしたら、実際に Python ファイルを作成し、実行してみる。

  1. 「ファイル (File)」 > 「新規ファイル (New File)」を選択する。
    新規ファイルメニュー
  2. 新しいエディタ画面(中身は空)が開くことを確認する。
    空のエディタ画面
  3. 「ファイル (File)」 > 「名前を付けて保存 (Save As...)」を選択し、ファイル名に .py の拡張子 (例: hello.py) を付けて保存する。
    名前を付けて保存の画面
  4. 保存するディレクトリ(フォルダ)を指定する。すでに同一名のファイルが存在する場合は確認が表示される。
  5. .py ファイルを初めて開くと、リンター (Pylint など) やフォーマッター (Black など) の追加の拡張機能のインストールを推奨される場合がある。これらはコードの品質向上に役立つため、必要に応じてインストールする。
  6. エディタ画面に、簡単な Python プログラムを入力する。
    print("Hello, World!")
    Hello World プログラムを入力した画面
  7. エディタ右上の「実行 (Run)」ボタン (緑色の三角アイコン ▷) をクリックする。これにより、現在 VS Code で選択されている Python インタープリターを使ってスクリプトが実行される。
    実行ボタンの位置
  8. 画面下部の「ターミナル」パネルに Hello, World! と表示されることを確認する。
    実行結果が表示されたターミナル
  9. 複数の Python 環境がシステムに存在する場合、VS Code ウィンドウ右下のステータスバーに表示されている Python のバージョン (例: Python 3.12.1 64-bit) をクリックすることで、使用するインタープリターを切り替えることができる。
    Python インタープリター選択

Python デバッガの使用

VS Code の Python 拡張機能には、デバッグ機能が含まれている。ここでは基本的な使い方を紹介する(Python 拡張機能がインストールされていることが前提である)。

C 言語プログラムの編集と C/C++ 拡張機能

VS Code は C 言語のプログラム編集にも適している。ここでは基本的なファイル作成と、開発を助ける C/C++ 拡張機能について説明する。

  1. Visual Studio Code を起動する。
  2. 「ファイル (File)」 > 「新規ファイル (New File)」を選択する。
    新規ファイルメニュー
  3. 新しいエディタ画面(中身は空)が開くことを確認する。
    C言語ファイルの空のエディタ
  4. 「ファイル (File)」 > 「名前を付けて保存 (Save As...)」を選択し、ファイル名に .c の拡張子 (例: main.c) を付けて保存する。
  5. 保存するディレクトリ(フォルダ)を指定する。すでに同一名のファイルが存在する場合は確認が表示される。
  6. .c ファイルを初めて開くと、「C/C++ Extension Pack」のインストールを推奨されることがある。これは Microsoft 提供の拡張機能で、C/C++ のコード補完 (IntelliSense)、デバッグ、コードナビゲーションなどを強化する。インストールを推奨する。

    推奨されなかった場合や後でインストールする場合は、拡張機能ビューで C/C++ と検索し、Microsoft 提供のものをインストールする。

    C/C++ Extension Pack のインストール推奨
  7. エディタ画面に、簡単な 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;
    }
    C言語プログラムの入力例
  8. VS Code は C 言語のコードエディタおよびデバッガのインターフェースであるが、C プログラムのコンパイル(実行可能ファイルの生成)と実行には、別途 C コンパイラ (例: MSVC の cl、GCC、Clang) がシステムにインストールされている必要がある。

    コンパイラがインストールされていれば、VS Code のターミナルから gcc main.c -o main のようなコマンドでコンパイルし、./main で実行できる。

    より高度なビルドやデバッグ設定については、VS Code の tasks.jsonlaunch.json ファイルの設定が必要になる(この記事の範囲外)。

その他の便利な拡張機能

VS Code は拡張機能でカスタマイズできる。拡張機能ビュー (Ctrl+Shift+X) や以下のマーケットプレイスで探すことができる。

Visual Studio Marketplace: https://marketplace.visualstudio.com/