Pythonでプログラミングを始めたい場面は、データ分析やWebアプリ開発など、さまざまな文脈で頻繁に発生します。環境構築の初期段階でよく行われるのが動作確認や初期設定であり、コードの実行やライブラリの管理をスムーズに進めるための準備です。
この記事では、Pythonの導入直後に実施する基本的な設定を解説していきます。エラーへの対処やおすすめエディタの導入手順など、サンプルコード付きで解説していきますので、ぜひ参考にしてください。
目次
- Pythonをインストールした後にやるべきこと
- ターミナルやコマンドで動作確認する
- VS Codeなどのエディタを導入する
- 今後のためにpipや仮想環境の設定を行う
- WindowsでPythonのPATH設定が通らない場合の対処方法
- Pythonインストーラを再ダウンロードして修復インストールする手順
- Pythonをインストールした後に関するよくある質問
- pythonコマンドが認識されない場合はどうすればいいですか?
- IDLEとVS Codeはどちらを使うのがいいですか?
- macOSでPythonをインストールした後にpython3コマンドが見つからない場合はどうすればいいですか?
- とにかく早くWindows環境でPythonを使えるようにするにはどうすればいいですか?
Pythonをインストールした後にやるべきこと
Pythonをパソコンに導入した直後は、正しく起動するか確かめる初期設定が欠かせません。環境変数やエディタの準備を整えることによって、プログラミングを快適に進めることが可能です。
導入直後に実施したい主な作業は、以下の通りです。
- コマンドを利用したバージョンと動作の確認
- VS Codeなどの高機能エディタのインストール
- 仮想環境の構築とパッケージ管理ツールの設定
これらの設定を順番に進めれば、開発中のエラーや環境トラブルを未然に防げるという仕組みです。それぞれの具体的な手順を、順番に見ていきましょう。
ターミナルやコマンドで動作確認する
まずはインストールされたPythonが、OSから正しく認識されているか確認します。コマンドプロンプトやターミナルを開き、コマンドを入力してバージョン情報が表示されるか確かめる手順です。
動作確認を実行するコマンドは、OSによって、以下のように異なります。
# Windows(コマンドプロンプト/PowerShell)
python --version
# macOS / Linux(python3が一般的なコマンド)
python3 --version
上記のコマンドを実行し、バージョン番号が表示されれば基本的な動作確認は完了です。macOSでは標準でPythonが同梱されていないため、python3コマンドが見つからない場合はPython公式サイト macOS向けダウンロードページからインストールするか、Xcodeコマンドラインツールをインストールする必要があります。
バージョンが表示されない場合は、環境変数PATHにPythonのインストールパスが追加されていない可能性があります。具体的な対処方法は後述の「WindowsでPythonのPATH設定が通らない場合の対処手順」で解説しているため、エラーが発生した場合はそちらを参照してください。
続いて、pip(Pythonのパッケージ管理ツール)も正しく認識されているか確認しておくと確実です。以下のコマンドでpipのバージョン情報が表示されれば、パッケージのインストール準備は整っています。
pip --version
# または
python -m pip --version
Windows環境では、Python公式ドキュメント「Pythonランチャー for Windows」で解説されているpyランチャー(Windowsインストーラに同梱された、複数バージョンのPythonを管理・起動するWindows専用ツール)を利用した起動も選択肢の一つです。Python公式サイトから最新版を導入すれば、pyランチャーも同時にセットアップされる仕組みです。
なお、Python 3.14以降ではPython Install Managerとの統合により、pyコマンドの動作が変わる可能性がある点に留意してください。
VS Codeなどのエディタを導入する
動作確認が完了したら、次にプログラムを書きやすくするためのエディタを準備します。特にVS Code公式サイトから入手できるエディタは拡張機能が豊富で、多くの開発者に利用されている便利なツールです。
エディタ上でPythonの簡単なプログラムを実行する例は、以下の通りです。
print("Hello World!")
VS Code単体では、上記コードの実行ボタンは表示されません。Python拡張機能(Microsoft製、名称:「Python」、拡張機能ID:ms-python.python)をインストールした後に実行ボタンが使用可能です。
実行ボタンを押すだけで結果を画面に出力できるようになり、エディタのターミナル機能を活用すれば画面を切り替えずに動作テストを行えるという仕組みです。
エディタの導入時は、あわせて日本語化拡張機能(Japanese Language Pack for VS Code)もインストールしておくと操作しやすくなります。Python拡張機能は構文のエラーチェックやコードの自動補完を有効にしてくれるため、本格的な開発を行う際は導入をおすすめします。
今後のためにpipや仮想環境の設定を行う
本格的な開発を始める前に、プロジェクトごとに環境を分ける仮想環境の構築をおすすめします。他のプロジェクトとの依存関係の衝突を防ぎ、環境をクリーンに保てるからです。
Python公式ドキュメントでは、venvモジュールの役割を次のように説明しています。
venv モジュールは、それぞれが独自の Python パッケージの集合をサイトディレクトリに持つ、軽量な仮想環境の作成をサポートします。
出典:Python公式ドキュメント venvモジュール
つまり、プロジェクトごとに独立したパッケージ環境を用意できるため、ライブラリのバージョン競合を防げるという仕組みです。標準搭載のvenvを使って、まず仮想環境フォルダを作成するコマンドを実行します。
python -m venv myenv
上記のコマンドを実行すると「myenv」という専用フォルダが作成されますが、利用するにはさらに有効化が必要です。Python 3.4以降ではpipも自動で配置されるため、続いて以下のコマンドでお使いの環境に合わせた有効化を実行してください。
# Windows(コマンドプロンプト)
myenv\Scripts\activate.bat
# Windows(PowerShell)
myenv\Scripts\Activate.ps1
# macOS / Linux
source myenv/bin/activate
PowerShellで「UnauthorizedAccess」などの実行ポリシーエラーが出た場合は、Microsoft公式ドキュメント「about_Execution_Policies」を参照のうえ、現在のユーザーのみに適用する「Set-ExecutionPolicy RemoteSigned -Scope CurrentUser」を実行するか、コマンドプロンプトで代わりにactivate.batを使用してください。
有効化が完了するとコマンドプロンプトの先頭に「(myenv)」と表示されます。この状態でパッケージ管理ツールのpipを使えば、特定の環境だけにライブラリを導入可能です。
Debian/UbuntuなどのLinux環境でpipの別途導入が必要な場合はsudo apt install python3-pipで対応してください(Windows/macOS公式インストーラからダウンロードして導入した場合は不要です)。仮想環境の利用は複数の開発プロジェクトを並行する際に役立ち、pip公式サイトやPyPIからパッケージをダウンロードする方法と組み合わせれば、環境の競合を気にせず安全に管理できます。
WindowsでPythonのPATH設定が通らない場合の対処方法
Pythonのインストール後に「コマンドが認識されない」というエラーが出た場合は、インストール時の設定を見直す必要があります。WindowsでPythonが正しく動作しない主な原因は、PATHの設定漏れです。
Windows環境でのPATH設定確認ポイントは、以下の通りです。
- インストーラ起動時に「Add Python to PATH」のチェックを入れたか
- インストール後に新しいコマンドプロンプトを開いて確認したか
- システムを再起動してからpython --versionを試したか
PATHを後から追加する場合は、Windowsの「システムの詳細設定」→「環境変数」から手動で追加するか、Pythonのインストーラを再度実行して修復インストールを選択してください。
Pythonインストーラを再ダウンロードして修復インストールする手順
PATHの設定が通らない場合の確実な対処法として、Python公式サイト Windows向けダウンロードページからインストーラを再取得する方法があります。
python.orgのダウンロードページでは、従来型の.exeインストーラ(Windows installer 64-bit)が引き続き提供されています。Python 3.14以降はPython Install Managerという新たな導入手段も追加されていますが、従来のexeインストーラも廃止されておらず、どちらの方法でもダウンロードして導入可能です。
インストール方法はバージョンによって、変わる可能性があるため、ダウンロードページで最新情報を確認してください。再インストール時に確認すべき主な項目は、以下の通りです。
| 確認項目 | 正しい状態 |
|---|---|
| 「Add Python to PATH」 | チェック入り(必須) |
| bit数の選択 | 64bit版(特別な理由がない限り) |
| インストール方式 | 従来の.exeインストーラまたはPython Install Manager(3.14以降) |
インストール完了後は、新しいコマンドプロンプトを開いてpython --versionを実行し、バージョンが表示されることを確認してください。
Pythonをインストールした後に関するよくある質問
pythonコマンドが認識されない場合はどうすればいいですか?
環境変数PATHにPythonのインストールパスが設定されていない可能性があります。Windowsの「環境変数」設定からパスを手動で追加するか、インストーラを再実行して「Add Python to PATH」にチェックを入れる方法で解決できます。
macOS・Linux環境ではpython3 --versionコマンドで確認してください。詳しい手順は本記事の「WindowsでPythonのPATH設定が通らない場合の対処手順」で解説しています。
IDLEとVS Codeはどちらを使うのがいいですか?
プログラミングを始めたばかりの方には、Pythonインストール時に同梱されるIDLE(統合開発環境)が最初のとっかかりとして手軽です。一方、本格的な開発を進めるなら、コード補完やデバッグ機能が充実したVS Codeが多くの開発者に利用されています。
VS CodeでPythonを実行するにはMicrosoft製の「Python」拡張機能(ms-python.python)のインストールが必要です。用途や習熟度に合わせて選択するのがおすすめです。
macOSでPythonをインストールした後にpython3コマンドが見つからない場合はどうすればいいですか?
macOSでは標準でPythonが同梱されていないため、Python公式サイト macOS向けダウンロードページから.pkgインストーラをダウンロードするか、ターミナルでbrew install python3(Homebrewが必要)を実行して導入してください。
インストール後はpython3 --versionでバージョン番号が表示されれば環境構築は完了です。Xcodeコマンドラインツールの導入を促すダイアログが表示された場合は、それに従って導入すればpython3が使えるようです。
とにかく早くWindows環境でPythonを使えるようにするにはどうすればいいですか?
最短でPython環境を整えたい場合は、OS標準のストアやコマンドを活用するのが効果的です。たとえばWindows環境であれば、Microsoft Storeから直接取得するか、ターミナルでwinget(Windowsパッケージマネージャ)コマンドを実行するだけで導入を完了できます。
ただし、特定のバージョンを指定したい場合や細かなPATH設定をカスタマイズしたい場合は、公式サイトからインストーラを取得する手順を踏むのが確実です。学習の目的や用途に合わせて、最適な導入手段を選んでください。
※上記コンテンツの内容やソースコードはAIで確認・デバッグしておりますが、間違いやエラー、脆弱性などがある場合は、コメントよりご報告いただけますと幸いです。
ITやプログラミングに関するコラム
PythonをWebで実行する方法
共通テスト「情報Ⅰ」2年目で変わる、日本の教育と学び方
gitでブランチ(branch)を切り替える方法
git cloneでブランチを指定する方法
64GBのメモリが必要な人・不要な人の特徴
PCを再起動するコマンド一覧
CapsLock以外で大文字になる原因【Windows編】
パソコンで大文字になるのを解除する方法
面白いAIの活用事例を業界別に紹介
Gitでcommit(コミット)を取り消す方法
ITやプログラミングに関するニュース
株式会社HODL1がAI経営管理エージェントを提供開始、少人数での経営管理効率化を支援
株式会社サードスコープがKanataを発表、法人向けAI業務支援SaaSを展開
株式会社ナレッジセンスがChatSenseのPPTX出力機能を強化、資料修正負荷の軽減を支援
株式会社すららネットが「すらら」同時導入を公表、夜間中学で日本語学習と教科学習を支援
DUAL株式会社が空室通電DXと賃貸革命の連携を開始、空室時の通電管理効率化を推進
株式会社ITLINEがAWS生成AIシステム開発・運用を提供開始、企業管理型AI基盤の構築を支援
合同会社ウノマスがAI対応スコアを正式公開、LLMOとSEOの横断診断を支援
Markefan株式会社がmarke.aiを提供開始、BtoBマーケティングの属人化抑制を支援
株式会社FinatextがAIロールプレイング提供開始、金融機関の営業育成基盤構築を支援
株式会社アンドパッドがANDPAD ナレッジAIを提供開始、建設現場の情報検索と共有を支援
