次の方法で共有


Windows で Python 開発環境を設定する

Windows で Python 環境を数分で準備します。手動で設定するか、winget を使用してすべてを自動化します。 以下のものが必要です。

  • Python 3.13 – 最新の Python ランタイム
  • Visual Studio Code – 軽量で強力なコード エディター
  • Visual Studio Code 用 Python 拡張機能 – Python 言語のサポート、デバッグ、リンティングなどを追加

以下の WinGet 構成ファイル では、上記のすべてが自動的にインストールされます。

作業を開始するには:

  1. Windows ターミナルで PowerShell を開き、次のコマンドを実行します。

    winget configure -f https://aka.ms/python-config
    
  2. 構成が開始されると、ターミナル ウィンドウにセットアップ手順と必要なインストールが表示されます。 それらを確認し、[Y] [はい] または [N] [いいえ] を選択して続行して確認します。

  3. 必要なワークロードがインストールされます。 python --versionを実行して、セットアップを確認します。

これで Python 開発の準備ができました。

よく寄せられる質問

pip インストールでのパッケージのインストールに関する問題

インストールが失敗する理由は多数あります。多くの場合、適切なソリューションはパッケージ開発者に連絡することです。

問題の一般的な原因は、変更するアクセス許可がない場所にインストールしようとしている場合です。 たとえば、既定のインストール場所には管理者特権が必要な場合がありますが、既定では Python には管理者特権は必要ありません。 最適な解決策は、 仮想環境 を作成し、そこにインストールすることです。

一部のパッケージには、C または C++ コンパイラをインストールする必要があるネイティブ コードが含まれています。 一般に、パッケージ開発者はプリコンパイル済みバージョンを発行する必要がありますが、多くの場合は発行しません。 これらのパッケージの一部は、 Build Tools for Visual Studio をインストール して C++ オプションを選択した場合に機能することがありますが、ほとんどの場合、パッケージ開発者に連絡する必要があります。

StackOverflow に関する説明に従う

WSL での pip のインストールに関する問題

linux 用 Windows サブシステム (WSL または WSL2) に pip を含むパッケージ (Flask など) をインストールすると、 python3 -m pip install flaskなど、次のようなエラーが発生する可能性があります。

WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None))
after connection broken by 'NewConnectionError('<urllib3.connection.VerifiedHTTPSConnection
object at 0x7f655471da30>: Failed to establish a new connection: [Errno -3]
Temporary failure in name resolution')': /simple/flask/

アフターマーケットファイアウォールを実行していない限り、おそらく解決策は pip を再インストールすることです。

sudo apt -y purge python3-pip
sudo python3 -m pip uninstall pip
sudo apt -y install python3-pip --fix-missing
py.exeとは

さまざまな種類の Python プロジェクトに取り組んでいるため、コンピューターに複数のバージョンの Python がインストールされる可能性があります。 これらはすべて python コマンドを使用するため、使用している Python のバージョンが明らかでない場合があります。 標準として、 python3 コマンド (または python3.7 を使用して特定のバージョンを選択する) を使用することをお勧めします。

py.exe ランチャーは、インストールした Python の最新バージョンを自動的に選択します。 py -3.7などのコマンドを使用して特定のバージョンを選択したり、py --listを使用して使用できるバージョンを確認したりすることもできます。 ただし、py.exe ランチャーは、 python.org からインストールされた Python のバージョンを使用している場合にのみ機能します。Microsoft Store から Python をインストールする場合、 py コマンドは 含まれません。 Linux、macOS、WSL、Microsoft Store バージョンの Python の場合は、 python3 (または python3.7) コマンドを使用する必要があります。

実行中の python.exe が Microsoft Store を開くのはなぜですか?

新しいユーザーが Python の適切なインストールを見つけられるように、Microsoft Store で公開されているコミュニティのパッケージの最新バージョンに直接移動するショートカットが Windows に追加されました。 このパッケージは管理者権限なしで簡単にインストールでき、既定の python コマンドと python3 コマンドを実際のコマンドに置き換えます。

コマンドライン引数を指定してショートカット実行可能ファイルを実行すると、Python がインストールされていないことを示すエラー コードが返されます。 これは、意図されていない可能性がある場合に、バッチ ファイルとスクリプトがストア アプリを開くのを防ぐためです。

python.org のインストーラーを使用して Python をインストールし、[パスに追加] オプションを選択すると、新しい python コマンドがショートカットよりも優先されます。 他のインストーラーは、組み込みのショートカットよりも優先順位のpythonを追加する場合があることに注意してください。

[スタート] から [アプリの実行エイリアスの管理] を開き、"アプリ インストーラー" Python エントリを見つけて "オフ" に切り替えることで、Python をインストールせずにショートカットを無効にすることができます。

ファイル パスをコピーして貼り付けると、Python でファイル パスが機能しないのはなぜですか?

Python 文字列では、特殊文字に "エスケープ" が使用されます。 たとえば、文字列に改行文字を挿入するには、「 \n」と入力します。 Windows 上のファイル パスでは円記号が使用されるため、一部の部分が特殊文字に変換されている可能性があります。

Python でパスを文字列として貼り付けるには、 r プレフィックスを追加します。 これは、それが raw 文字列であり、" を除いてエスケープ文字が使用されていないことを示します (パス内の最後の円記号を削除する必要がある場合があります)。 パスは次のようになります。 r"C:\Users\MyName\Documents\Document.txt"

Python でパスを操作する場合は、標準の pathlib モジュールを使用することをお勧めします。 これにより、スラッシュや円記号を使用するかどうかにかかわらずパス操作を一貫して実行できる豊富な Path オブジェクトに文字列を変換できるため、異なるオペレーティング システム間でコードの動作が向上します。

PYTHONPATH とは

PYTHONPATH 環境変数は、モジュールをインポートできるディレクトリの一覧を指定するために Python によって使用されます。 実行中に、 sys.path 変数を調べて、何かをインポートするときに検索されるディレクトリを確認できます。

コマンド プロンプトからこの変数を設定するには、 set PYTHONPATH=list;of;pathsを使用します。

PowerShell からこの変数を設定するには、Python を起動する直前に $env:PYTHONPATH='list;of;paths' を使用します。

環境変数 の設定 を使用してこの変数をグローバルに設定することはお勧 めしません 。これは、使用する予定のバージョンではなく、任意のバージョンの Python で使用される可能性があるためです。

パッケージ化とデプロイに関するヘルプはどこで入手できますか?

Docker: VSCode 拡張機能 を使用すると、Dockerfile テンプレートとdocker-compose.yml テンプレートを使用して迅速にパッケージ化およびデプロイできます (プロジェクトに適した Docker ファイルを生成します)。

Azure Kubernetes Service (AKS) を使用すると、必要に応じてリソースをスケーリングしながら、コンテナー化されたアプリケーションをデプロイおよび管理できます。

異なるマシン間で作業する必要がある場合はどうなりますか?

設定同期 を使用すると、GitHub を使用して、異なるインストール間で VS Code の設定を同期できます。 異なるマシンで作業する場合は、環境の整合性を維持するのに役立ちます。

PyCharm、Atom、Sublime Text、Emacs、Vim の使用に慣れたりするとどうなるでしょうか。

VSCode 拡張機能 キーマップは、作業環境を普段の環境のように快適にするのに役立ちます。

Mac のショートカット キーを Windows ショートカット キーにマップする方法

キーボード ボタンとシステム ショートカットの一部は、Windows コンピューターと Macintosh で若干異なります。 この Mac から Windows への移行ガイド では、基本について説明します。

VS Code での Python の使用の詳細については、どこで確認できますか?
  • VS Code での Python の編集: VS Code の Python 用オートコンプリートおよび IntelliSense サポートを活用する方法の詳細(その動作をカスタマイズする方法や、それらをオフにする方法)について説明します。
  • Linting Python: Linting は、潜在的なエラーのコードを分析するプログラムを実行するプロセスです。 PYTHON 向けに VS Code が提供するさまざまな形式のリンティング サポートと、それを設定する方法について説明します。
  • Python のデバッグ: デバッグは、コンピューター プログラムからエラーを識別して削除するプロセスです。 この記事では、VS Code を使用して Python のデバッグを初期化および構成する方法、ブレークポイントの設定と検証、ローカル スクリプトのアタッチ、さまざまなアプリの種類またはリモート コンピューターでのデバッグの実行、基本的なトラブルシューティングについて説明します。
  • 単体テスト Python: 単体テストの意味、チュートリアルの例、テスト フレームワークの有効化、テストの作成と実行、テストのデバッグ、およびテスト構成設定の背景について説明します。