直接将多级绝对路径用冒号（Linux/macOS）或分号（Windows）连接后赋值给PYTHONPATH环境变量即可，但需确保路径顺序正确、无重复、无末尾斜杠，且对应目录下存在__init__.py以构成有效包。
Python多级目录怎么加进PYTHONPATH
直接把多级路径用冒号（Linux/macOS）或分号（Windows）连起来塞进PYTHONPATH就行，但顺序和重复会直接影响import行为。
-
PYTHONPATH是环境变量，不是Python代码里的东西，改完要重启终端或重新加载shell配置（比如source ~/.zshrc） - 路径之间必须用
:（Unix系）或;（Windows），不能混用，也不能漏写——漏一个分隔符会导致整个变量被忽略 - 路径末尾不加
/，加了反而可能在某些Python版本里报ImportError: No module named xxx - 路径必须是绝对路径，相对路径（如
./src）在PYTHONPATH里无效
为什么import还是找不到模块，明明PYTHONPATH里有
常见原因是模块没放在包根目录下，或者__init__.py缺失——PYTHONPATH只控制搜索路径，不自动识别子目录为包。
- 假设你加了
/home/user/project到PYTHONPATH，但想import utils.helper，那必须确保/home/user/project/utils/__init__.py存在，且helper.py在该目录下 - 如果模块文件在
/home/user/project/src/utils/helper.py，那应该把/home/user/project/src加进PYTHONPATH，而不是/home/user/project - 可以用
python -c "import sys; print('\n'.join(sys.path))"确认路径是否生效、顺序是否符合预期
sys.path.insert(0, ...)和PYTHONPATH哪个优先
sys.path.insert(0, ...)优先级最高，它会插在搜索路径最前面，比PYTHONPATH还早被检查。
- 在脚本开头写
sys.path.insert(0, '/path/to/my/module')，能临时覆盖PYTHONPATH里的同名模块 - 但这种方式只对当前进程有效，不适合部署；而
PYTHONPATH是全局生效的，适合开发环境统一配置 - 注意：多次
insert(0, ...)会导致路径重复，可能引发意外的模块覆盖，建议先if path not in sys.path:判断
Windows下设置PYTHONPATH总不生效
大概率是系统变量和用户变量搞混了，或者PowerShell和CMD读取逻辑不同。
立即学习“Python免费学习笔记（深入）”；
- 在CMD里用
set PYTHONPATH=...只对当前窗口有效；要用setx PYTHONPATH "C:\a;C:\b"写入注册表（需重启CMD） - PowerShell默认不读
setx设的变量，得用$env:PYTHONPATH="C:\a;C:\b"临时设置，或在$PROFILE里持久化 - VS Code终端可能缓存旧环境，改完变量后要关掉所有终端再重启窗口，不然
print(sys.path)看到的还是老的
PYTHONPATH——它只会安静地导入错的模块，或者抛出模糊的ModuleNotFoundError。 
