MacでVS Codeを使ってPythonを書いたものの、

• 実行しても何も起きない
• エラーが出て原因が分からない
• ターミナルでは動くのにVS Codeでは動かない

といった経験はありませんか。

VS CodeでPythonが実行できない原因は、
**コードそのものではなく「実行環境のズレ」**であることがほとんどです。

この記事では、
Mac環境で VS CodeからPythonが実行できないときに確認すべき原因と直し方 を
初心者向けに整理して解説します。

※ 本記事は Mac環境（python3）を前提 に説明します。

この記事でわかること

• VS CodeでPythonが実行できない主な原因
• ターミナルとVS Codeの違い
• Python実行時に確認すべきポイント
• 初心者が見落としやすい注意点

原因① Python自体が実行できる状態か確認する

まず、
VS Code以前にPythonが使える状態かを確認します。

ターミナルを開き、次を実行してください。

python3 --version

バージョンが表示されれば、
Python自体は問題なく使える状態です。

ここでエラーが出る場合は、
PythonのインストールやPATHに問題があります。

原因② VS CodeのターミナルとmacOSターミナルが違う

VS Codeには、
内蔵ターミナルがあります。

このとき、

• macOSのターミナルで実行している
• VS Code内のターミナルで実行している

この2つが混在すると、
環境がズレることがあります。

VS Codeで作業する場合は、
VS Code内のターミナルで実行するのが安全です。

原因③ VS Codeで選択されているPythonが違う

VS Codeでは、
使用するPythonを明示的に選択できます。

しかし、

• 別のPythonが選ばれている
• 仮想環境ではないPythonが使われている

というケースが非常に多いです。

確認方法：

• VS Code画面下部（ステータスバー）を確認
• Pythonのバージョンやパスが表示されているか

意図したPythonになっていない場合は、
選択を切り替える必要があります。

原因④ 実行コマンドが間違っている

Macでは、
python ではなく python3 を使うのが基本です。

次のような違いがあります。

python test.py   # エラーになることがある
python3 test.py  # 推奨

VS Codeのターミナルでも、
必ず python3 を使っているか確認してください。

原因⑤ 実行している場所とファイルの場所が違う

Pythonファイルを実行する際、
現在のディレクトリと
ファイルの保存場所が一致していないと実行できません。

確認ポイント：

• ls コマンドでファイルが見えるか
• test.py が存在するディレクトリで実行しているか

場所が違う場合は、
正しいディレクトリに移動してから実行してください。

よくある勘違い

VS CodeでPythonが実行できないとき、
次のような勘違いがよくあります。

• VS Codeを開いただけでPythonが使えると思っている
• ターミナルとVS Codeの環境が同じだと思っている
• Pythonの選択状態を確認していない
• python と python3 の違いを意識していない

多くの場合、
設定を一つ確認するだけで解決します。

まとめ

MacでVS CodeからPythonが実行できない場合は、
次の順番で確認してください。

1. Python自体が実行できるか
2. VS Code内のターミナルを使っているか
3. 正しいPythonが選択されているか
4. python3 を使っているか
5. 実行場所が正しいか

これらを一つずつ確認すれば、
ほとんどのケースは解決できます。