MS Store版Python无法从自定义PYTHONPATH导入模块求助

1. 确认模块实际安装位置 #

用--target指定自定义目录安装模块时，模块会被放到该目录下的site-packages文件夹里——如果只把自定义根目录加到PYTHONPATH，Python找不到里面site-packages下的模块。

• 直接打开自定义目录，检查是否存在site-packages，把这个子路径加到PYTHONPATH才对，比如原来加的是/my/custom/path，现在改成/my/custom/path/site-packages。
• 顺便核对模块文件结构：包里有没有__init__.py（Python 3.3+可省略，但部分旧模块依赖该文件），或者有没有拼写错误的包名。

2. 检查sys.path的顺序与生效时机 #

• 打印sys.path看看自定义路径是否排在系统默认site-packages之后？如果是，Python会优先加载系统里的模块，把自定义路径插到最前面试试：

  import sys
  sys.path.insert(0, "/你的自定义路径（或site-packages路径）")
  

• 确保PYTHONPATH是在启动Python前设置的，比如终端里先执行export PYTHONPATH="/你的路径:$PYTHONPATH"，再启动Python，避免脚本临时添加路径后缓存残留的问题。

3. 核对pip与Python解释器的匹配性 #

很多时候是用错了pip：比如用pip3安装到自定义目录，但运行脚本用的是python（指向Python2），或者没激活虚拟环境，导致解释器读取的是另一个环境的路径。

• 验证命令：

  which python  # 查看当前运行的Python路径
  which pip     # 查看pip对应的Python路径
  

• 保险起见，用python -m pip install --target=你的自定义目录 模块名，强制用当前Python的pip安装，避免版本不匹配。

4. 清除模块缓存 #

Python会生成__pycache__目录和.pyc文件缓存模块，有时候路径修改后缓存未清，仍会加载旧模块：

• 删除自定义目录下模块对应的__pycache__文件夹
• 重启Python会话，不要在同一个终端里反复测试，缓存会残留。

5. 根据具体错误信息定位问题 #

别只说“导入失败”，把具体错误贴出来更易排查：

• 如果是ModuleNotFoundError：先确认模块名拼写正确，且确实在自定义路径的site-packages里存在
• 如果是ImportError：大概率是模块内部依赖未安装，或者包结构存在问题（比如子模块引用错误）

内容的提问来源于stack exchange，提问作者Jakdeebear