VS Codeのエージェントモードを拡張するには、を試してください!

VS Code で Python を使用するためのクイック スタート ガイド

Python 拡張機能を使用すると、Visual Studio Code は優れた Python エディターになり、あらゆるオペレーティング システムで動作し、さまざまな Python インタープリターで使用できます。

次のものをインストールして始めましょう。

Gif installing the Python extension in a fresh install of VS Code

VS Code を Python 用にさらにカスタマイズするには、Python プロファイル テンプレートを活用して、推奨される拡張機能と設定を自動的にインストールできます。データ サイエンス プロジェクトの場合は、データ サイエンス プロファイル テンプレートの使用を検討してください。

Gif showing the Python profile template being installing into VS Code.

Python プロジェクトまたはファイルを作成して開く方法

VS Code で作業したい既存の Python プロジェクトがある場合は、VS Code のようこそページまたはファイル エクスプローラー ビューからフォルダーまたはファイルを開くか、[ファイル] > [フォルダーを開く] (Ctrl+K Ctrl+O) または [ファイル] > [ファイルを開く] (⌘O (Windows、Linux では Ctrl+O)) を選択して開始できます。

VS Code のようこそページで [新しいファイル] を選択し、次に [Python ファイル] を選択するか、[ファイル] > [新しいファイル] () に移動することで、新しい Python ファイルを作成できます。

ヒント: VS Code で既にワークスペース フォルダーを開いている場合は、新しいファイルやフォルダーを既存のプロジェクトに直接追加できます。ファイル エクスプローラー ビューの最上位フォルダーにある対応する [新しいフォルダー] または [新しいファイル] アイコンを使用して、新しいフォルダーとファイルを作成できます。

UIツアー

VS Code を初めて起動するときは、Python 固有の機能と UI を利用するために Python 拡張機能をインストールする必要があります。Python 拡張機能をインストールした後の UI を見てみましょう。

Image of the Python UI highlights in VS Code.

コードアクション

コード アクション (クイック修正とも呼ばれます) は、コードに警告がある場合に問題を修正するのに役立ちます。これらの役立つヒントは、エディターの左マージンに電球 (💡) として表示されます。電球を選択してコード アクションのオプションを表示します。これらのコード アクションは、Python、Pylance、または VS Code 自体などの拡張機能から提供されます。コード アクションの詳細については、「Python のクイック修正」を参照してください。

Screenshot showing Code Actions in a Python project.

Python コマンド

Python コマンドには、コマンド パレット (⇧⌘P (Windows、Linux では Ctrl+Shift+P)) からアクセスできます。コマンド パレットから、VS Code およびインストールされている拡張機能のさまざまな機能にアクセスできます。コマンド パレットに "Python: " と入力すると、Python 拡張機能で利用できるコマンドが見つかります。

Gif demonstrating how to access Python commands in the Command Palette.

実行、デバッグ、テスト

VS Code での Python に慣れてきたところで、コードを実行、デバッグ、テストする方法を学びましょう。

実行

VS Code で Python コードを実行するには、いくつかの方法があります。

エディターで開いている Python スクリプトを実行するには、エディターの右上にある [ターミナルで Python ファイルを実行する] の再生ボタンを選択します。

Image showing the Run Python File in Terminal play button.

VS Code 内で Python コードのスニペットを繰り返し実行するには、他にも方法があります。

  • 1 行以上を選択し、Shift+Enter を押すか、右クリックして [選択範囲/行を Python ターミナルで実行] を選択します。このコマンドは、ファイルの一部だけをテストするのに便利です。
  • コマンド パレット (⇧⌘P (Windows、Linux では Ctrl+Shift+P)) から、[Python: REPL を開始] コマンドを選択して、現在選択されている Python インタープリター用の REPL ターミナルを開きます。REPL では、コードを 1 行ずつ入力して実行できます。

デバッグ

デバッガーは、コード実行のフローを検査し、エラーをより簡単に特定したり、プログラムの実行中に変数やデータがどのように変化するかを調べたりできる便利なツールです。調査したい行の横のガターをクリックして Python プロジェクトにブレークポイントを設定することで、デバッグを開始できます。

Screenshot showing a debugger breakpoint in a Python program.

デバッグを開始するには、F5 を押してデバッガーを初期化します。このファイルを初めてデバッグする場合、デバッグしたいアプリケーションの種類を選択できる構成メニューが開きます。Python スクリプトの場合は、[Python ファイル] を選択できます。

プログラムがブレークポイントに到達すると、停止し、Python デバッグ コンソールでデータを追跡し、デバッグ ツールバーを使用してプログラムを進めることができます。

Gif showing how to configure the Python debugger for the first time.

Python のデバッグ機能の詳細については、「VS Code での Python のデバッグ」を参照してください。

テスト

Python 拡張機能は、Unittestpytest の堅牢なテスト サポートを提供します。

アクティビティ バーのテスト ビューで [Python テストを構成する] を選択し、お好みのテスト フレームワークを選択することで、Python テストを構成できます。

Python プロジェクトのテストを作成することもでき、お好みのフレームワークが構成されると、Python 拡張機能がそれらを検出しようとします。Python 拡張機能では、テスト ビューでテストを実行およびデバッグし、[テスト結果] パネルでテスト実行の出力を確認することもできます。

Gif demonstrating test configuration, discovery, and run in the Python extension.

テスト機能の包括的な説明については、「VS Code での Python のテスト」を参照してください。

次のステップ

人気の Python Web フレームワークで Web アプリを構築する方法を学ぶには、以下のチュートリアルを参照してください。

Visual Studio Code の Python でさらに多くのことを探求できます。

  • Python プロファイル テンプレート - 厳選された拡張機能、設定、スニペットのセットで新しいプロファイルを作成します。
  • コードの編集 - Pythonのオートコンプリート、IntelliSense、書式設定、リファクタリングについて学びます。
  • Linting - 様々なPythonリンターを有効にし、構成し、適用します。
  • デバッグ - Pythonをローカルおよびリモートでデバッグする方法を学びます。
  • テスト - テスト環境を構成し、テストを発見、実行、デバッグします。
  • 設定リファレンス - VS CodeのPython関連設定の全範囲を探索します。