VS CodeでPythonが実行できない時の対処法｜初心者向けガイド

VS CodeでPythonを実行しようとしてもうまく動かない場合、環境設定や拡張機能の問題が原因となることが多いです。本記事では、初心者でも簡単に確認・対処できる方法を段階的に解説します。

Pythonがインストールされているか確認する

まず、Python自体が正しくインストールされているか確認します。ターミナルやコマンドプロンプトで以下を入力してください。

python --version
# または
python3 --version

バージョン情報が表示されればインストール済みです。表示されない場合は、公式サイトからインストールしましょう。

VS CodeのPython拡張機能を確認

VS CodeではPython拡張機能が必要です。拡張機能タブで「Python」を検索し、Microsoft製の拡張をインストールしてください。

インストール後、再起動するとPythonファイルの実行が可能になります。

Pythonインタプリタの選択

複数バージョンのPythonがインストールされている場合、VS Codeで使用するインタプリタを選ぶ必要があります。

ステータスバー右下のPythonバージョンをクリックして、実行したいバージョンを選択してください。正しいパスが設定されていないと、実行できないことがあります。

コード実行の方法

Pythonファイルを開いた状態で、右上の「▶ Run Python File」をクリックするか、ターミナルで以下を入力して実行できます。

python ファイル名.py
# または
python3 ファイル名.py

これで、VS Code上でPythonスクリプトが実行されるはずです。

よくあるトラブルと解決策

1. ターミナルが別の環境を参照している → VS Codeのターミナル設定を確認

2. 拡張機能が古い → 最新バージョンに更新

3. ファイルの保存場所や名前に問題 → 半角英数字でパスを整理

まとめ

VS CodeでPythonが実行できない場合は、Pythonのインストール確認、拡張機能の導入、インタプリタの選択、実行方法の順に確認するのが基本です。

これらを順にチェックすることで、初心者でもスムーズにPythonスクリプトをVS Codeで実行できるようになります。