PyCharm运行时模块搜索路径由当前工作目录、Source Root标记及运行配置中“Add content roots to PYTHONPATH”是否启用共同决定；三者需协同生效，缺一不可。
PyCharm 运行时模块搜索路径由什么决定
PyCharm 运行 Python 脚本时，sys.path 不是固定不变的，它取决于三个关键因素：当前工作目录、是否标记了 Source Root、以及运行配置中是否启用「Add content roots to PYTHONPATH」。这三者共同决定了 import utils 这类语句能否成功——不是 PyCharm “认不认识”，而是 Python 解释器在哪儿找。
标记 Source Root 是最稳的导入方式
这是 PyCharm 特有的路径管理机制，不改代码、不污染 sys.path，且不影响命令行运行。操作后，该目录下所有子模块都能被项目内任意位置直接导入。
- 在项目视图中右键目标文件夹（比如
utils或src），选 Mark Directory as → Sources Root - 文件夹图标变成蓝色，说明已生效
- 检查运行配置：
Run → Edit Configurations…→ 勾选 Add content roots to PYTHONPATH（默认开启） - 验证：在任意脚本里打印
print('\n'.join(sys.path))，确认该目录路径出现在列表中
工作目录错位会导致相对路径和模块导入双失败
很多人遇到 ModuleNotFoundError 同时又报 FileNotFoundError: ./data/train.csv，根本原因就是工作目录没设对。PyCharm 默认把当前文件所在目录设为工作目录，但多数项目结构要求以项目根目录为准。
PyCharm 2026.2
下载
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包，下载地址指向官方 Windows 安装包直链，可用于旧项目兼容、版本回退和环境测试。
- 打开
Run → Edit Configurations… - 选中你的运行配置，在 Working directory 栏填入
$PROJECT_DIR$（表示项目根目录） - 如果必须按当前文件位置运行（比如调试单个工具脚本），可改为
$FileDir$ - 切勿手动写死绝对路径，否则换机器就失效
临时加路径只适合调试，别进正式代码
用 sys.path.append() 确实能绕过路径问题，但它让导入逻辑脱离项目结构，也掩盖了真实路径设计缺陷。
- 仅限一次性测试或快速验证，比如在
exp3/data_gen.py里临时加sys.path.append(os.path.abspath('..')) - 永远不要在
__init__.py或主入口里写这种代码 - 如果发现多个地方都需要这样补，说明 Source Root 没标对，或者包结构缺失
__init__.py - 注意：用
os.path.abspath()而不是os.getcwd()，避免因工作目录变动导致路径计算错误
真正容易被忽略的是：Source Root 和工作目录是两个独立开关，必须同时配对生效。只标了 Source Root 但工作目录仍指向子目录，open('./config.yaml') 还是会找不到；反之，工作目录设对了但没标 Source Root，from utils import helper 依然报错。两者缺一不可。
