Windows 11でVS CodeとPythonの開発環境を構築する方法｜インストール手順・PATHを通す・拡張機能【画面キャプチャつき】

Python 環境構築

はじめに：VS CodeとPythonで開発環境を用意する

「Excel VBAでの自動化はやっているけれど、そろそろPythonにも挑戦したい」「効率化のためにPythonを学びたいけれど、最初の環境構築でつまずきそう」——この記事はそんな方向けです。

Windows 11のPCに VS Code（Visual Studio Code） と Python本体 をインストールし、最初のプログラム（Hello, World!）を動かすところまでを、全手順の画面キャプチャつきで解説します。初心者がつまずきやすい「PATHを通す」設定と「パスの文字数制限の解除」も省略せずに扱います。

Step 1：VS Codeのインストール

まずはコードを書くためのエディタ「VS Code」を用意します。

インストーラーの実行

VS Code公式サイト にアクセスし、「Download for Windows」から「Windows x64 ユーザーインストーラー」をクリックして exe ファイルをダウンロードします。

ダウンロードした exe（インストーラー）を実行して、セットアップを開始します。

使用許諾契約に「同意する」を選び、「次へ」をクリックします。

インストール先はそのままで「次へ」をクリックします。

「次へ」をクリックします。

追加タスクの選択画面です。そのまま「次へ」をクリックします（「PATH への追加」は既定でチェックが入っています）。

「インストール」をクリックします。

インストールが進みます。しばらく待ちます。

「完了」をクリックしてVS Codeを起動します。

拡張機能の追加

VS Codeに、Microsoft公式の拡張機能を入れて使いやすくします。画面左端の「拡張機能」アイコン（四角が4つのマーク）をクリックすると、検索と追加ができます。

VS Codeが起動したら、画面左端の「拡張機能」アイコンをクリックします。

① 日本語化（Japanese Language Pack）

インストール直後のVS Codeは英語表記です。日本語化すると操作しやすくなります。

検索欄に「日本語」と入力します。

「Japanese Language Pack for Visual Studio Code」が表示されるので「Install」をクリックします。右下に再起動を促すメッセージが出たら「Change Language and Restart」をクリックすると、メニューが日本語になります。

② Python 拡張機能

検索欄に「Python」と入力します。

「Python」（発行者：Microsoft）が表示されるので「Install」をクリックします。

③ autoDocstring

Pythonのコメント（docstring）の雛形を自動生成してくれる拡張機能です。ダブルクォートやカッコの補完も効くようになります。

検索欄に「autoDocstring」と入力します。

「autoDocstring – Python Docstring Generator」が表示されるので「Install」をクリックします。

Step 2：Python本体のインストール

次に、プログラムを実行するための「Python」本体をインストールします。ここがいちばん重要なステップです。

Python公式サイト にアクセスします。

メニューの「Downloads」から「Windows」をクリックします。

使っているPCに対応する「Windows installer (64-bit)」をクリックしてダウンロードします。

ダウンロードした exe（インストーラー）を実行します。

ここが最重要です。「Install Now」を押す前に、画面下の 「Add python.exe to PATH」にチェックを入れてから「Install Now」をクリックします。

セットアップが進みます。しばらく待ちます。

完了画面に「Disable path length limit」と表示されたら、クリックしておくのがおすすめです。これでPythonのインストールは完了です。

Pythonが入ったか確認する

VS Codeの下側にある「ターミナル」を開きます（表示されていなければ、メニューの「表示」→「ターミナル」）。そこに次のコマンドを入力してEnterを押します。

Python 3.xx.x のようにバージョンが表示されれば、インストールは成功です。

最初のプログラム：Hello, World! を動かす

作業フォルダを開く

左端の「エクスプローラー」アイコンをクリックし、「フォルダーを開く」をクリックします。

任意のフォルダ（例：デスクトップに作った test フォルダ）を選びます。

「このフォルダー内のファイルの作成者を信頼しますか?」と聞かれたら「はい、作成者を信頼します」をクリックします。

test.py を作って実行する

フォルダ名の右にある「新しいファイル」アイコンをクリックします。

ファイル名を test.py と入力してファイルを作成します。拡張子 .py は自動では付かないので、忘れずに付けてください。

エディタに下のコードを1行書き、右上の ▶ ボタンをクリックして実行します。

print("Hello, World!")

画面下部のターミナルに Hello, World! と表示されれば成功です。Pythonを動かす準備が整いました。

「Hello, World!」が表示されなかったら

ターミナルに python は、内部コマンドまたは外部コマンドとして認識されていません と出た場合は、インストール時の「Add python.exe to PATH」にチェックを入れ忘れた可能性が高いです。次の手順で直せます。

1. ダウンロードしたPythonのインストーラー（exe）をもう一度実行します。
2. 「Modify」をクリックします。
3. 次の画面で「Next」、その次の画面で 「Add Python to environment variables」 にチェックを入れて、インストールし直します。

そのあとPCを再起動して、もう一度VS Codeで実行してみてください。

まとめ：この環境で作れるもの

Windows 11でのPython開発環境の構築を解説しました。ポイントは「Add python.exe to PATH」のチェックを忘れないこと、この1点だけです。環境が整えば、あとはやりたいことに合わせてコードを書いていくだけです。

当ブログでは、この環境を使って作った実務向けのツール開発記を公開しています。次に読むならこのあたりです。

よくある質問（FAQ）