【VSCode】Pythonの実行方法を解説

当ページのリンクには広告が含まれています。

記事の文字数：3177

Visual Studio Code（VSCode）を使ってPythonプログラムを実行するための手順を、プラグインのインストールから基本的な実行方法、トラブル対処まで初心者にもわかりやすく解説します。前提としてVSCodeに加えてPythonをインストールしておく必要があります。

2025/1/8 2025/5/10更新

Visual Studio Code（VSCode）は、Python開発において人気のあるエディタの1つです。シンプルなインターフェースと豊富な拡張機能により、初心者からプロの開発者まで幅広く支持されています。無料で利用でき、軽量かつ高速で動作する点も魅力です。

本記事では、VSCodeでPythonを実行するための手順を、初期設定から実行方法、トラブルシューティングまで網羅的に解説します。これからPythonを始めようとしている方や、VSCodeを使い始めたばかりの方にとって有益になればと思います。

前提

まずは、VSCodeでPythonを実行するための基本的な準備を整える必要があります。開発環境を正しく構築することで、スムーズにPythonコードを動かすことができ、後々のトラブルも防げます。

VSCodeをインストールしていること。
- バージョンは以下で実施。

1
バージョン: 1.96.2 (user setup)
2
コミット: fabdb6a30b49f79a7aba0f2ad9df9b399473380f
3
日付: 2024-12-19T10:22:47.216Z
4
Electron: 32.2.6
5
ElectronBuildId: 10629634
6
Chromium: 128.0.6613.186
7
Node.js: 20.18.1
8
V8: 12.8.374.38-electron.0
9
OS: Windows_NT x64 10.0.26100

VSCode実行環境にPythonをインストールしていること。
- バージョンは以下で実施。

1
>python -V
2
Python 3.13.1

Pythonのインストール

Python公式サイトにアクセスし、使用しているOSに対応したインストーラーをダウンロードしてインストールします。インストール時には必ず使用しているOSに対応したインストーラーをダウンロードしてインストールします。インストール時には「Add) Python to PATH（環境変数に追加）」にチェックを入れてください。これを忘れると、VSCodeからPythonを正しく呼び出せないことがあります。

VSCodeのインストール

VSCodeはMicrosoftが開発・提供している無料のエディタです。公式サイトからダウンロードし、インストールしてください。Windows・macOS・Linuxなど主要なOSに対応しています。

VSCode起動

VSCodeを起動し、実行したいPythonコードが格納されているフォルダーを開きます。

VSCodeでフォルダーを開く

対象フォルダを指定してフォルダーの選択を押下します。

フォルダーの選択

以下のようにエクスプローラーにPythonコードが表示されればOKです。

VSCodeでフォルダー選択後

「Python」拡張機能のインストール

VSCodeを初めて起動したら、サイドバーの拡張機能（Extensions）アイコンをクリックし、「Python」と検索します。Microsoft製のPython拡張機能が表示されるので、それをインストールしてください。この拡張機能により、シンタックスハイライトやコード補完、デバッグ、仮想環境の選択など多くの機能が使えるようになります。

拡張機能(Ctrl+Shift+X)を押下します。

拡張機能を選択

Pythonを検索して、インストールを押下します。

拡張機能Pythonインストール

以下のように表示されたらインストール完了です。

拡張機能Pythonインストール完了

Pythonの実行方法

VSCodeでは、さまざまな方法でPythonスクリプトを実行できます。それぞれの方法には特徴があり、用途に応じて使い分けることができます。本記事では代表的な4つの実行方法を紹介します。

Pythonスクリプトの作成

実際にPythonファイルを作成して、簡単なスクリプトを書いてみましょう。

任意の作業フォルダを作成してVSCodeで開きます。
新規ファイルを作成し、example1.py という名前を付けて保存します。
以下のように簡単なコードを記述してみてください。

1
num = 5
2
if num % 2 == 0:
3
    result = "偶数"
4
else :
5
    result = "奇数"
6
print(result)

このコードは、奇数または偶数を表示するプログラムで、ターミナルに文字列を表示します。

PythonをRunボタンで実行

ファイルを開いた状態で、エディタ上部にある「Run」または「▶」のアイコンをクリックすると、VSCodeが自動的にPythonスクリプトをターミナルで実行します。この方法は、GUIベースで簡単に操作できるため、初心者にもおすすめです。

Pythonファイルを右クリックで実行

エクスプローラー（Ctrl+Shift+E）に切り替えて、実行したいPythonファイルを選択し右クリックします。

Python実行-ファイル選択

ファイルを右クリックしたらRun Python File in Terminal（or ターミナルでPythonファイルを実行する）をクリックして実行します。

Python実行-右クリック・実行

以下のようにVSCodeのターミナルでPythonコードが実行されました。

Python実行-実行後画面

Pythonをターミナルから実行

メニューバーの「ターミナル」>「新しいターミナル」を選択するか、`Ctrl + Shift + “（バッククォート）でターミナルを開きます。
作業ディレクトリがスクリプトファイルと同じ場所であることを確認してから、次のコマンドを入力します：

1
python example1.py

実行すると、ターミナル上に 奇数 と表示されます。

Jupyterでインタラクティブ（対話型）な実行

Jupyterスタイルのインタラクティブな実行には、以下の拡張機能が必要です。

Jupyter（Microsoft製）

Python拡張機能「Jupyter」をインストールすると、VSCode上でJupyter風のインタラクティブ実行が可能になります。コード内に # %% を記述してセルを分けると、各セルごとに実行できるようになります。

1
# %%
2
print("セル1")
3

4
# %%
5
print("セル2")

セルの上に表示される「Run Cell」ボタンをクリックすると、その部分だけを即時実行でき、逐次的なデバッグや試行錯誤に便利です。特にデータ分析や機械学習の場面で効果を発揮します。

以下のように、セルの実行を押下するとセル単位で実行できます。

Jupyter実行画面

この拡張機能は、Python拡張機能と連携して動作し、セル単位の実行やノートブック形式のインターフェースをVSCode上で実現します。拡張機能パネルで「Jupyter」と検索し、インストールしてください。

実行時に以下のようなダイアログが表示されたらipykernelパッケージをインストールしてください。

Jupyter-ipykernelパッケージインストール

よくあるトラブルと対処法

VSCodeでPythonを実行する際によく遭遇する問題と、その対処方法を以下にまとめます。

“pythonコマンドが見つかりません” と表示される

→ Pythonをインストールした際にPATHに追加されていない可能性があります。まず、ターミナルで python --version を実行して、バージョン情報が表示されるか確認しましょう。表示されない場合は、Pythonの再インストールで「PATHに追加」にチェックを入れるか、PATHを手動で設定してください。また、VSCode右下のステータスバーでPythonの実行環境が正しく選択されているかも確認しましょう。