【初心者向け】VS CodeでPython環境構築！パス（PATH）を通す時の注意点とハマりどころを解説

プログラミングを始めようとして、最初に誰もがぶつかる壁が「環境構築」です。

特に「Pythonのインストールはできたけれど、VS Codeで実行しようとするとエラーが出る」「ターミナルで命令が認識されない」といったトラブルは、プログラミング学習者だけでなく、別言語からPythonに触れ始めたエンジニアにとっても“よくあるハマりどころ”です。

今回は、VS Code（Visual Studio Code）を使ってPythonの開発環境を整える手順と、初心者が最もつまずきやすい「パス（PATH）の設定」について、原因と具体的な対処法を分かりやすく解説します。

VS CodeでPythonを動かす基本の流れ

手順自体は非常にシンプルで、大きく分けると以下の3ステップです。

しかし、ステップ1のインストール手順で「ある1箇所のチェックボックス」を見落とすと、次のステップで確実にエラーが発生します。

公式サイトからインストーラー（Windows版など）をダウンロードして実行すると、一番最初の画面下に以下のようなチェックボックスが表示されます。

☐ Add python.exe to PATH（または Add Python to environment variables）

実は、このチェックボックスにチェックを入れずに「Install Now」を押してしまうケースが後を絶ちません。

「パス（PATH）を通す」とは、簡単に言えば「パソコンのどこからでもPythonのプログラムを呼び出せるように、PCにPythonの居場所を教えてあげる設定」のことです。

ここにチェックを入れずに進めてしまうと、PCはPythonがどこにインストールされたかを理解できません。その結果、VS Codeのターミナルやコマンドプロンプトで python --version と入力しても、以下のようなエラーが出ることになります。

'python' は、内部コマンドまたは外部コマンド、操作可能なプログラムまたはバッチファイルとして認識されていません。

「もうチェックを外したまま完了しちゃった…」という場合でも、PCを初期化したり難解な設定画面を開く必要はありません。一番手っ取り早く確実な解決策は「インストーラーの再実行（Modify）」です。

ダウンロードしたPythonのインストーラーファイル（python-3.x.x-amd64.exe）をもう一度ダブルクリックして開きます。
メニュー画面が表示されるので、「Modify（変更）」を選択します。
オプション機能の選択画面が出たら、そのまま「Next」を押します。
「Advanced Options」の画面で、「Add Python to environment variables（環境変数にPythonを追加）」にチェックを入れて「Install」を押します。

これで手動で環境変数をいじることなく、安全にパスを通すことができます。