使用._pth时脚本目录未入sys.path，Python模块导入失败求助

我刚解决了一个和你完全一样的问题——自己编写的Python脚本和模块文件放在同一目录，用ActivePython运行完全正常，但切换到嵌入式发行版就弹出ModuleNotFoundError: No module named 'pyWhich'。排查后确认，问题核心就是嵌入式发行版和ActivePython的sys.path变量设置逻辑不一样，下面给你拆解原因和可行的解决方案：

为什么会出现这个差异？ #

• ActivePython默认会自动把当前脚本所在的目录添加到sys.path里，所以同目录的模块能被直接识别并导入
• 而Python嵌入式发行版出于轻量化和环境隔离的设计，默认不会将脚本所在目录加入sys.path，它的搜索路径只包含嵌入式包自带的库目录

快速解决方案（三种方法任选） #

方法1：手动在脚本中添加路径 #

在主脚本的最开头插入这段代码，强制把脚本所在目录加入模块搜索路径：

import sys
import os

# 获取当前脚本的绝对目录路径
script_dir = os.path.dirname(os.path.abspath(__file__))
# 将目录加入sys.path的最前端，确保优先搜索
if script_dir not in sys.path:
    sys.path.insert(0, script_dir)

这样不管用哪种Python环境运行，同目录的pyWhich模块都能被正确找到。

方法2：用.pth文件配置全局路径 #

如果需要长期固定这个搜索路径，可以在嵌入式Python的Lib/site-packages目录下创建一个名为custom_paths.pth的文件，文件里直接写入你的脚本所在目录的绝对路径，例如：

C:\Projects\MyPythonScripts

嵌入式Python启动时会自动读取这个文件里的路径并添加到sys.path，一劳永逸解决问题。

方法3：通过批处理脚本设置环境变量 #

如果你是用批处理文件调用嵌入式Python，可以在bat里临时设置PYTHONPATH环境变量：

@echo off
set PYTHONPATH=C:\Projects\MyPythonScripts
.\python.exe my_main_script.py

这种方式不需要修改Python代码，适合不想改动脚本的场景。

验证设置是否生效 #

可以在脚本开头加一段代码打印sys.path，确认你的脚本目录已经被加入搜索路径：

import sys
print("当前sys.path内容：", sys.path)

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