pythonpath 设置后 import 报错，首要确认解释器是否读取了它：ide（如 pycharm、vs code）通常不继承 shell 的 pythonpath，需在对应配置中手动启用或设置环境变量；终端中直接运行 python script.py 才会生效。
PYTHONPATH 设置后 import 还报错？先确认解释器是否真的读取了它
Python 启动时确实会读 PYTHONPATH，但仅限于**当前 shell 环境下启动的解释器**。如果你在 IDE（如 PyCharm、VS Code）里运行脚本，它很可能没继承系统或 shell 的环境变量，而是用自己配置的 Python 解释器路径和 sys.path —— 此时改 PYTHONPATH 完全无效。
验证方法很简单：在目标环境下运行以下代码：
import sys
print('\n'.join(sys.path))
检查输出里有没有你加的路径。没有？说明环境变量根本没生效，别急着调代码，先看启动方式。
- 终端中直接敲
python script.py→ 会读当前 shell 的PYTHONPATH - VS Code 点“运行 Python 文件” → 默认不读，需在
.vscode/settings.json里配python.defaultInterpreterPath或启用python.terminal.launchArgs - PyCharm → 在 “Run > Edit Configurations” 里勾选 “Add content roots to PYTHONPATH” 和 “Add source roots to PYTHONPATH”，或手动填 Environment variables
Linux/macOS 下临时与永久设置 PYTHONPATH 的区别很关键
临时设置只对当前终端会话有效，适合调试；永久设置一旦写错可能让所有 Python 脚本启动失败，必须谨慎。
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。
- 临时：
export PYTHONPATH="/path/to/my/modules:$PYTHONPATH"（注意加$PYTHONPATH保留原有路径） - 永久（推荐只加到个人配置）：
echo 'export PYTHONPATH="/path/to/my/modules:$PYTHONPATH"' >> ~/.bashrc（zsh 用户改~/.zshrc），然后source ~/.bashrc - 绝对不要写进
/etc/environment或全局 profile —— 系统级 Python 工具（如apt调用的python3）可能因路径污染崩溃
另外，路径里含空格或中文？别这么干。Python 对这类路径解析不稳定，尤其在 subprocess 调用时容易 silently 失败。
Windows 上 set 和 setx 命令行为完全不同
set PYTHONPATH=... 只在当前 cmd 窗口有效；setx PYTHONPATH "..." 才写入注册表，但**不会影响已打开的窗口**，连新打开的 cmd 都要重启资源管理器才能确保继承（更稳妥是重启 cmd 或整个终端）。
- 命令行临时用：
set PYTHONPATH=C:\mylib;%PYTHONPATH% - 永久写注册表：
setx PYTHONPATH "C:\mylib;%PYTHONPATH%"（引号不能少） - PowerShell 用户注意：
$env:PYTHONPATH="C:\mylib;$env:PYTHONPATH"是会话级，永久需改[Environment]::SetEnvironmentVariable - 路径分隔符必须用分号
;，不是冒号:—— 写错会导致整个sys.path解析中断，import 全挂
比 PYTHONPATH 更可靠的方式：用 .pth 文件或 pip install -e
直接改环境变量是“最粗暴也最容易出问题”的方案。真正稳定的路径管理，优先走 Python 自身机制：
- 在
site-packages目录下放一个myproject.pth文件，内容就一行路径：C:\dev\myproject（Linux 用/home/user/myproject），Python 启动时自动加载 - 开发阶段用
pip install -e /path/to/my/package，相当于把包“软链接”进 site-packages，路径自动生效且支持源码热修改 - 如果只是临时测试，直接改
sys.path最快：import sys; sys.path.insert(0, "/path")，但仅限脚本开头，且不能解决子进程或导入链中的路径问题
很多人卡在 PYTHONPATH 不生效，其实是因为忽略了 Python 的模块查找顺序：内置模块 > 当前目录 > sys.path（含 PYTHONPATH）> 安装路径。路径加错位置、顺序不对、甚至大小写不一致（尤其 Windows + WSL 混用时），都会导致 import 看似失败。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
