VS Code での Python クイックスタートガイド

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

インストールして始めましょう

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

Python 用に VS Code をさらにカスタマイズするには、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 関連のすべての設定を調べます。