VS CodeでPythonプロジェクトを作成する方法

編集済み 2 数日前 によって ExtremeHow 編集チーム

パイソンビジュアルスタジオコードVSコードIDEプロジェクト設定ウィンドウズマックリナックスプログラミングツール開発

Visual Studio Code (VS Code)を使用してPythonプロジェクトを作成するのは、初心者にも経験豊富なプログラマーにも大いに役立つシンプルなプロセスです。VS Codeは、Microsoftが開発した多用途で軽量なコードエディタで、特にPythonをサポートするさまざまなプログラミング言語をサポートしています。デバッグ、タスクの実行、バージョン管理、およびコーディング体験を向上させるための拡張機能の豊富なマーケットプレイスなどの機能を提供します。このステップバイステップガイドでは、VS Codeを使用してゼロからPythonプロジェクトを設定する方法を説明します。

要件

始める前に、次の前提条件がコンピュータにインストールされていることを確認してください。

• Python ランタイム: Python の公式ウェブサイトから Python をダウンロードしてインストールする必要があります。インストールオプションでは、Python をシステムの PATH 変数に追加するように設定されていることを確認してください。
• VS Code: 公式 Visual Studio Code ウェブサイトから入手可能で、無料のソースコードエディタです。
• VS Code 用の Python 拡張機能: この拡張機能は、コード補完 (Intellisense)、リント、およびデバッグなど、Python でのコーディングに必要なすべてのサポートを提供します。VS Code の拡張機能マーケットプレイスから簡単にインストールできます。

VS Code のインストール

まず、公式ウェブサイトからオペレーティングシステム用の VS Code インストーラーをダウンロードします。提供されているインストール手順に従い、特に開発に関連するすべての必要なコンポーネントが選択されていることを確認します。インストールが完了したら、VS Code を起動します。

Python 環境の設定

Python のインストール

Python をインストールするには、公式 Python ウェブサイト にアクセスして、お使いの OS 用のインストーラーをダウンロードします。インストーラーを実行し、最適な構成オプションを選択し、指示があればシステム PATH に Python を追加します。

VS Code に Python 拡張機能をインストール

VS Code を起動し、ウィンドウのサイドのアクティビティバーにある拡張アイコンをクリックするか、Ctrl+Shift+X ショートカットを使用して拡張ビューを開きます。拡張機能マーケットプレイスで「Python」を検索します。Microsoft の Python 拡張機能を追加するには「インストール」をクリックします。この拡張機能は、Python アプリケーションの開発に必要なエディタに Python 特有の重要な機能を追加します。

新しいPythonプロジェクトを作成する

Python と必要な拡張機能を設定した後、次のステップとして新しい Python プロジェクトを作成します。以下の方法で VS Code を使って実行できます。

新しいワークスペースの開設

VS Code 内のワークスペースは、Python プロジェクトファイルを管理するためのコンテナです。開始するには、VS Code を開き、ファイルメニューから「フォルダーを開く」を選択します。Python プロジェクトファイルを保存する希望のディレクトリーに新しいフォルダーを作成します。フォルダーを作成したら、それを選択して VS Code で開きます。

Python ファイルの作成

プロジェクトフォルダー内に新しい Python ファイルを作成します。Explorer のビュ (フォルダー/ファイルと一緒にある左サイドバー) で「新しいファイル」アイコンをクリックするか、ファイルメニューを使用して「新しいファイル」を選択してこれを行うことができます。例えば main.py という説明的な名前を付けます。これは、コードを書くメインの Python スクリプトファイルとなります。

Python コードを書く

Python はインタプリタ言語なので、Python ファイルを作成した直後にコードを書いて実行することができます。

簡単なプログラムを書く

最初に、コンソールに「Hello, World!」を出力する簡単なプログラムを作成しましょう。次のコードを main.py ファイルに書き込みます。

print("Hello, World!")

Python コードを実行する

Python スクリプトを実行するには、いくつかのオプションがあります。最も簡単な方法は、VS Code で直接ターミナルを開くことです。トップメニューで「ターミナル」を選択し、それから「新しいターミナル」を選択してターミナルを開きます。ターミナルで、main.py ファイルがある正しいディレクトリにいることを確認し、次のコマンドを入力してスクリプトを実行します。

python main.py

すべてが正しく設定されている場合、出力は次のようになります。

Hello, World!

VS Code デバッガーの使用

VS Code の強力な機能の 1 つは組み込みのデバッガーで、コードの問題を特定し修正するのに使用できます。デバッガを使用するには、スクリプトファイルの行番号の左側にあるガターをクリックしてブレークポイントを設定します。これにより、スクリプトの実行が停止する位置を示す小さな赤い点が作成されます。

デバッガの設定

デバッグを開始するには、アクティビティバーのデバッグアイコンに移動し、ギアアイコンをクリックして launch.json 設定ファイルを開きます。VS Code は Python プロジェクト用のデフォルト設定を提案します。必要に応じて調整できます。

例 launch.json 設定:

{ "version": "0.2.0", "configurations": [ { "name": "Python: Current File", "type": "python", "request": "launch", "program": "${file}", "console": "integratedTerminal" } ] }

デバッグセッションの開始

ブレークポイントを設定し、デバッガ構成を確認した後、F5 を押すかデバッグメニューで 「デバッグの開始」をクリックしてデバッガを開始します。Python スクリプトが実行され、ブレークポイントで実行が停止し、変数の検査やコードのステップ実行、問題の特定が可能になります。

Python プロジェクトの依存管理

依存関係の管理は Python プロジェクトにおいて重要であり、仮想環境を使用することで効率的に管理できます。

仮想環境の作成

プロジェクトフォルダー内で、ターミナルで次のコマンドを実行して仮想環境を作成します。

python -m venv venv

このコマンドは、新しいディレクトリ venv を作成し、スタンドアロンの Python インストールと他のスクリプトと実行ファイルを格納します。グローバルにインストールされているパッケージとは別に依存関係を整理するのが良い方法です。

仮想環境のアクティベーション

仮想環境をアクティベートするには、次の操作を行います。

• Windows の場合:

  .\venv\Scripts\activate

• MacOS/Linux の場合:

  source venv/bin/activate

アクティブ化されると、通常、コマンドラインのプレフィックスとして (venv) が表示され、ターミナルのプロンプトに表示されます。

pip を使用してパッケージをインストール

仮想環境がアクティブな場合、pip を使用してパッケージをインストールできます。例えば、プロジェクトに numpy パッケージが必要な場合は、次のコマンドでインストールします。

pip install numpy

現在の環境の依存関係を requirements.txt ファイルに凍結し、バージョン管理リポジトリに登録するには、次を使用します。

pip freeze > requirements.txt

後で、プロジェクトにアクセスできる人は pip install -r requirements.txt を実行することで依存関係をインストールできます。

Git バージョン管理の使用

Git は、コードバージョンを管理し、他の人とコラボレーションするための重要なツールです。VS Code には組み込みの Git サポートがあり、変更の追跡やプロジェクトでの共同作業を容易にします。

Git リポジトリの初期化

プロジェクトフォルダーで Git リポジトリを初期化するには、VS Code のターミナルを開き、次を入力します。

git init

このコマンドは、プロジェクトディレクトリに新しい Git リポジトリを作成します。プロジェクトフォルダには .git ディレクトリが作成され、デフォルトでは非表示です。

初回のコミットを作成する

リポジトリが初期化されたら、変更をステージングしてコミットすることで最初のコミットを行います。次のコマンドを使用します。

git add . 
git commit -m "Initial commit"

最初のコマンドはすべてのファイルをステージングし、二つ目のコマンドは「初回のコミット」のメッセージでコミットを行います。

ソース管理ビューの使用

VS Code には Git 操作のための直感的な UI が提供されています。ソース管理アイコンをアクティビティバーからクリックして、変更のリストを表示し、変更をステージングして、VS Code インターフェイスを使用してコミットを作成できます。

まとめ

Visual Studio Code は、Python プロジェクトのライフサイクル全体をサポートする、非常に統合された開発環境を提供します。コードの書き込みと実行からデバッグ、依存管理、バージョン管理までをサポートします。

このガイドは、VS Code のインストール、Python の設定、プロジェクトワークスペースの作成、コードの書き込みと実行、デバッグツールの使用、仮想環境を使用した依存管理、Git バージョン管理の統合をカバーしています。これらのツールを効果的に活用することで、Python アプリケーションの開発、テスト、およびデプロイのプロセスを合理化し、個人および共同でのコーディングの生産性を向上させることができます。

  この記事をシェアする

記事の内容に誤りがある場合, あなたは 更新をリクエストできます