PyCharm找不到pip安装的库，95%是解释器不一致：需用python -c "import sys; print(sys.executable)"和which pip（或where pip）验证二者路径是否同源，若不一致则需在PyCharm中配置对应解释器并勾选“Inherit global site-packages”。
PyCharm 运行程序时找不到 pip 安装的库，95% 的情况是解释器不一致 —— 你用 pip 装包的 Python 和 PyCharm 实际运行代码的 Python 不是同一个。
确认当前 pip 和 Python 解释器是否同源
这是最该先做的一步，不是猜，是验证。在终端里运行这两条命令：
python -c "import sys; print(sys.executable)"
python -m pip show pip | grep Location
或者更直接地查 pip 本身路径：
which pip # macOS/Linux
where pip # Windows
如果 sys.executable 指向 /usr/local/bin/python3.11，而 which pip 返回 /opt/homebrew/bin/pip，那基本可以断定：pip 是 Homebrew 装的，但 Python 解释器可能是系统自带或另一个安装源，二者 site-packages 目录天然隔离。
- 必须确保两条命令输出的路径都落在同一 Python 安装目录下（比如都含
/Python3.11/） - 如果输出的是
/usr/bin/python3（macOS 系统自带）和/opt/homebrew/bin/pip，那就铁定错位 - Windows 上常见
C:\Users\Alice\AppData\Local\Programs\Python\Python311\python.exe和C:\Anaconda3\python.exe混用
PyCharm 中选错了解释器类型：Virtualenv vs System Interpreter
新建项目时勾选了 “New environment using Virtualenv” 或 “Pipenv”，PyCharm 就会创建一个空的、完全独立的环境。此时你在终端用全局 pip 装的包，对它来说根本不存在。
解决方法不是去 Terminal 里再 pip install 一遍，而是：
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包，下载地址指向官方 Windows 安装包直链，可用于旧项目兼容、版本回退和环境测试。
- 进
Settings → Project → Python Interpreter - 点右上角齿轮 →
Add...→ 左侧选System Interpreter - 在右侧路径框中，手动定位到你真正想用的那个
python.exe（比如和sys.executable输出一致的那个） - 关键一步：勾选
Inherit global site-packages（继承全局 site-packages）—— 否则即使指对了解释器，也不会加载你已装的包 - 点 OK，等待包列表刷新完成
注意：这个选项只在选择 System Interpreter 时才出现；Virtualenv 默认隔离，不提供该开关。
PyCharm 终端（Terminal）和运行配置（Run Configuration）用的不是同一个解释器
很多人在 PyCharm Terminal 里 pip install requests 成功了，但一 Run 就报 ModuleNotFoundError。这是因为：
- PyCharm Terminal 默认复用当前项目的 interpreter 设置（一般没问题）
- 但 Run Configuration 可能被手动改过：点右上角 ▶️ 旁的下拉箭头 →
Edit Configurations…→ 查看Python interpreter是否和 Settings 里一致 - 尤其注意：某些插件或脚本模板会悄悄覆盖 interpreter，导致“终端能装，运行就崩”
- 检查
Environment variables里有没有误设PYTHONPATH，它会干扰模块查找路径
简单验证法：在你的 Python 文件里加一行 import sys; print(sys.executable)，Run 一次，把输出路径和 Settings 里显示的 interpreter 路径逐字符比对。
缓存未刷新或 site-packages 权限异常
即使解释器选对、路径一致，有时 PyCharm 仍不识别已安装的包。这不是环境问题，而是 IDE 层面的同步延迟或文件权限卡点：
- 执行
File → Reload project from Disk强制重载项目结构 - 或
File → Invalidate Caches and Restart → Invalidate and Restart清掉索引缓存（尤其在换解释器后没自动更新包列表时） - Linux/macOS 下检查
site-packages目录是否可读：ls -l $(python -c "import site; print(site.getsitepackages()[0])") | head -3，确认没有Permission denied - Windows 上若用管理员装的包，但 PyCharm 是普通用户启动，也可能因 UAC 导致读取失败 —— 建议统一用非管理员身份管理 Python 环境
真正容易被忽略的点是：PyCharm 的 interpreter 配置界面里，“Show all packages” 列表有时会滞后几秒才加载完毕，刚切完解释器就急着写 import，IDE 还没来得及扫描完 site-packages 目录 —— 稍等 5 秒再看，或手动点右上角刷新按钮。
