Windows环境下已设PYTHONPATH与PATH，为何仍无法导入自定义模块？

AI 小北

2026-8-3

问题解答

1. `os.environ["PATH"]`无效的原因

PATH是系统用来查找可执行程序的环境变量，和Python模块导入逻辑无关。Python查找模块依赖的是sys.path列表（对应系统环境变量PYTHONPATH）。

你之前用bat设置PATH能成功导入，是因为Windows下Python启动时，会自动把PATH中的目录同步到sys.path里，但这是Python启动阶段的一次性操作——当你在脚本里修改os.environ["PATH"]时，Python已经完成初始化，不会再重新读取PATH来更新sys.path，所以即便PATH值改对了，也对模块导入没有帮助。

2. 脚本内正确设置路径的方法

核心是把所有自定义模块所在的目录添加到sys.path中，推荐两种方式：

方式一：直接扩展`sys.path`

把所有存放依赖模块的目录逐个加到sys.path，最直观可靠：

import sys
# 按顺序添加所有需要的模块路径
sys.path.extend([
    "C:/path/to/custom_module",
    "C:/path/to/custmod2",
    "C:/path/to/custmod3",
    "C:/path/to/custmod4"
])
# 现在可以正常导入
import custom_module
print("It works")

方式二：修改`PYTHONPATH`并同步到`sys.path`

如果习惯用环境变量管理路径，可以先修改os.environ["PYTHONPATH"]，再手动同步到sys.path：

import os
import sys
# 设置PYTHONPATH，包含所有模块目录
os.environ["PYTHONPATH"] = "C:/path/to/custom_module;C:/path/to/custmod2;C:/path/to/custmod3;C:/path/to/custmod4"
# 将PYTHONPATH拆分后添加到sys.path
sys.path.extend(os.environ["PYTHONPATH"].split(";"))

import custom_module
print("It works")