Pythonの環境構築で挫折するポイントと対処法｜「pythonが使えない」「pip installできない」をエラー別に解決

Pythonの学習で最初に挫折しやすいのは、文法ではなく環境構築です。つまずく場所は「pythonコマンドが使えない」「pip installできない」「入れたはずのライブラリが使えない」「ファイルが見つからない・文字化けする」のほぼ4つに決まっていて、エラーの文面ごとに直し方があります。

この記事では、実際に出るエラーの文面を手がかりに、原因と直し方を順に説明します。Python 3.14からWindowsのインストール方法が変わり、2026年10月9日に出たPython 3.15では文字コードの既定が変わったので、古い解説記事のとおりに進めて詰まる人も増えています。その変化もあわせて整理しました。学習全体の進め方でつまずく話はPython独学の進め方やプログラミングで挫折する理由とやってはいけない勉強法で扱っているので、ここでは環境構築に絞ります。

なぜ環境構築で挫折するのか

環境構築では、Pythonの文法とは関係のない知識が一度に求められます。コマンドの探し場所（PATH）、パソコンに入っている複数のPythonのどれが動いているか、ライブラリをどこに入れるか、ファイルの文字コード、といった話です。しかもエラーの文面が英語で、どこを直せばよいかが書かれていないことが多いので、初心者は手が止まります。

逆に言えば、つまずく場所は決まっています。まず自分がどこで止まっているかを、次の表で確かめてください。

出ているもの	原因	この記事の節
「’python’ は、内部コマンドまたは外部コマンド…として認識されていません」／Microsoft Storeが開く	Windowsでpythonコマンドが見つからない	つまずき1
zsh: command not found: python	Macではpython3と打つ必要がある	つまずき1
error: externally-managed-environment	OSや管理ツールのPythonに直接入れようとしている	つまずき2
ModuleNotFoundError: No module named '…'（入れたはずなのに）	pipとpythonが別のPythonを指している	つまずき3
FileNotFoundError、UnicodeDecodeError、文字化け	実行場所や文字コードの思い違い	つまずき4

つまずき1：pythonコマンドが使えない

Windows：コマンドが見つからない、Microsoft Storeが開く

Windowsでいちばん多いつまずきです。以前はpython.orgのインストーラーで「Add python.exe to PATH」のチェックを入れ忘れることが主な原因でした。

Python 3.14からは、Windows向けの標準のインストール方法が「Python install manager」に変わりました。従来のインストーラー（full installer）は3.14で非推奨になり、3.16以降は作られない予定です（Using Python on Windows、2026年10月18日確認）。公式ドキュメントによると、install managerはMicrosoft Storeかpython.orgから入れられ、入れたあとはpython・py・pymanagerの3つのコマンドが使えるようになります。インストーラーの変更点はPythonのWindowsフルインストーラー引退の記事でも解説しています。

それでもpythonと打つと「見つからない」と出る、あるいはMicrosoft Storeが開いてしまう場合、公式ドキュメントのトラブルシューティングでは次の確認を勧めています。

1. Python install managerを本当に入れたか確かめる
2. スタートメニューで「アプリ実行エイリアスの管理（Manage app execution aliases）」を開き、「Python (default)」のエイリアスが有効か確かめる（有効でも、一度オフにしてからオンに戻す）
3. pyとpymanagerのコマンドが動くか確かめる
4. 環境変数PATHに%UserProfile%\AppData\Local\Microsoft\WindowsAppsが入っているか確かめる

以前に別の方法でPythonを入れていたり、PATHを手で書き換えていたりすると、install managerのコマンドとぶつかることがあります。その場合は古いPythonを「アプリと機能」からアンインストールしてから入れ直すのが確実です。

Mac：python ではなく python3

Macのターミナルでpythonと打つと、次のように出ます（このMacで確認）。

zsh: command not found: python

Macではpython3と打ちます。ただし注意が必要で、Apple純正の開発ツール（Command Line Tools）に含まれる/usr/bin/python3は古い版のことがあります。この記事を書いたMacでは次のとおりでした。

$ python3 --version
Python 3.9.6

教材が新しい版を前提にしている場合、文法や機能が足りずにエラーになることがあります。python.orgから最新版を入れ、python3 --versionで版を確かめてから学習を始めてください。インストールの手順はPythonのローカル環境へのインストール方法にまとめています。

つまずき2：pip install ができない

‘pip’ が見つからない

pipだけが見つからないときは、Python経由で呼び出すと動くことがほとんどです。

python -m pip install pandas      # Windows
python3 -m pip install pandas     # Mac

-m pipは「このPythonに付いているpipを使う」という意味なので、次の「つまずき3」の取り違えも防げます。普段からこの書き方にしておくのがおすすめです。

error: externally-managed-environment

MacのHomebrewで入れたPythonや、Linux、管理ツールで入れたPythonでは、pip installが次のように止められることがあります。手元のツール（uv）で入れたPython 3.12で試した結果です。

error: externally-managed-environment

× This environment is externally managed
╰─> This Python installation is managed by uv and should not be modified.

これは壊れているのではなく、「このPythonはOSや管理ツールのものなので、直接ライブラリを入れないでほしい」という目印（PEP 668）です。Pythonの公式パッケージングガイドでも、この場合は仮想環境を使うよう案内するための仕組みだと説明されています（Externally Managed Environments、2026年10月18日確認）。エラー文には--break-system-packagesで無理に入れる方法も出ますが、OSや管理ツールの動作を壊すおそれがあるので、初心者は使わず、次の仮想環境を作ってください。

つまずき3：入れたはずのライブラリが使えない

pip installは成功したのに、実行するとModuleNotFoundErrorになる。これは、パソコンに複数のPythonがあり、pipが入れた先と、実行しているPythonが違うために起きます。VS CodeやJupyterでは、エディタが選んでいるPythonとターミナルのPythonが別、ということもよくあります。

実行しているPythonの場所は、次の1行で分かります。

import sys
print(sys.executable)

このMacで、Command Line ToolsのPythonから実行した結果です。

/Library/Developer/CommandLineTools/usr/bin/python3

表示された場所のPythonに対して（その場所）-m pip install …とすれば、確実にそのPythonに入ります。もっと簡単なのは、プロジェクトごとに仮想環境を作ることです。

python3 -m venv .venv            # 作成（Windowsは python -m venv .venv）
source .venv/bin/activate        # Macで有効化
.venv\Scripts\activate           # Windowsで有効化
python -m pip install pandas     # 有効化したまま入れる

有効化すると、プロンプトの先頭に(.venv)と表示されます。この表示があるときに入れたライブラリは、その仮想環境のPythonでだけ使えます。有効化してからsys.executableを表示すると、次のように仮想環境の中のPythonになっていることが確かめられます。

/Users/you/project/.venv/bin/python

VS Codeを使っている場合は、画面右下（またはコマンドパレットの「Python: Select Interpreter」）で、この.venvのPythonを選びます。ここが別のPythonのままだと、ターミナルでは動くのにエディタの実行ボタンでは動かない、という状態になります。仮想環境は、環境構築でつまずく人ほど早めに覚えておくと楽になります。ModuleNotFoundErrorと似たエラーの見分け方はModuleNotFoundErrorとImportErrorの違いで説明しています。

つまずき4：ファイルが見つからない・文字化けする

FileNotFoundError：実行している場所が違う

ファイルは確かにあるのに、次のように言われることがあります。

FileNotFoundError: [Errno 2] No such file or directory: 'data.csv'

open("data.csv")のような書き方は、スクリプトの置き場所ではなく、実行したときにターミナルがいたフォルダ（カレントディレクトリ）を基準に探します。project/sub/read.pyとproject/sub/data.csvを置き、projectフォルダからpython sub/read.pyと実行すると、ファイルは見つかりません。スクリプトの場所を基準にすれば、どこから実行しても読めます。

import os
from pathlib import Path

print(os.getcwd())                   # 今どこで実行しているか
base = Path(__file__).parent         # このスクリプトがあるフォルダ
print((base / "data.csv").read_text(encoding="utf-8"))

実行結果（projectフォルダからpython sub/read.pyで実行）：

/Users/you/project
a,b
1,2

文字化け・UnicodeDecodeError：文字コードの指定

Windowsでは、これまでencodingを指定せずにopen()すると、WindowsのANSIコードページ（日本語環境ならShift_JIS系）で読み書きしていました。そのため、UTF-8で保存したファイルを読むと文字化けやエラーになりました。

2026年10月9日にリリースされたPython 3.15では、WindowsでもUTF-8モードが既定で有効になり、encodingを省略したときの既定がUTF-8になりました（What’s New In Python 3.15・Using Python on Windows、2026年10月18日確認）。ただし3.14以前を使う人や、Excelが出力したShift_JISのCSVを読む場面はまだ多いので、ファイルを開くときはencoding="utf-8"（Shift_JISのファイルならencoding="cp932"）を明示する習慣にしておくと、版の違いで困りません。

挫折しないための進め方

最初はブラウザで動く環境で文法を覚える

環境構築でつまずいて学習そのものをやめてしまうくらいなら、最初はインストール不要の環境で文法を覚え、パソコンへのインストールは後に回すのが現実的です。Google Colaboratoryのようにブラウザだけで動く環境はPythonをブラウザで無料で使えるサイトで紹介しています。

止まったら、この順に確かめる

1. python --version（Macはpython3 --version）で版が表示されるか
2. python -m pip --versionでpipが動くか
3. print("hello")だけのファイルを実行できるか
4. 仮想環境を有効化してからpython -m pip installできるか
5. エディタが選んでいるPythonとsys.executableが一致しているか

どの段階で止まったかが分かれば、検索するときの言葉も決まります。エラーは最後の1行（FileNotFoundErrorやModuleNotFoundErrorなどの名前）をそのまま検索するのが近道です。代表的なエラーはPythonエラー一覧と対処法にまとめています。

人に画面を見てもらう

環境構築のつまずきは、パソコンごとに状態が違うため、文章で説明するより画面を見てもらうほうが早く片付くことがよくあります。通学型のプログラミングスクールのテックジムでは、自分のペースで課題を進め、詰まったところをその場でトレーナーに質問できます。まず試したい人向けに、無料Python講座（ゼロからはじめるPython入門講座）も開いていて、これまでに全国で2万人以上が参加しています。そのほかの無料講座は無料講座の一覧をご覧ください。

環境構築を終えたあとの学習手順はPython 始め方｜初心者向け学習ロードマップと環境構築の手順で解説しています。

よくある質問

Q. Pythonの環境構築で挫折しやすいのはどこですか？

pythonコマンドが見つからない、pip installができない、入れたライブラリが使えない、ファイルが見つからない・文字化けする、の4つがほとんどです。どれもエラーの文面で原因を切り分けられます。

Q. Windowsでpythonと打つとMicrosoft Storeが開きます

Python 3.14からの標準のインストール方法である Python install manager を入れたか確かめ、「アプリ実行エイリアスの管理」で Python (default) のエイリアスが有効か確認してください。有効でも、一度オフにしてオンに戻すと直ることがあります。

Q. 「externally-managed-environment」と出てpip installできません

OSや管理ツールが管理しているPythonに直接ライブラリを入れようとしているためです。python3 -m venv .venv で仮想環境を作り、有効化してから python -m pip install を実行してください。–break-system-packages は使わないほうが安全です。

Q. pip installしたのにModuleNotFoundErrorになります

pip が入れた先のPythonと、実行しているPythonが違います。import sys と print(sys.executable) で実行中のPythonを確かめ、そのPythonの -m pip で入れるか、仮想環境を作ってエディタでもそのPythonを選んでください。

Q. 環境構築が終わらないうちは学習を始められませんか？

始められます。Google Colaboratory のようにブラウザだけで動く環境で文法を先に覚え、パソコンへのインストールは後から行っても問題ありません。