VS Code中sys.path.append失效报ModuleNotFoundError Spyder正常如何修复

这个报错的核心是Python运行时的模块搜索路径（sys.path）没有包含DrivingInit.py所在的目录。Spyder默认会自动把项目下所有相关父目录、子目录加入模块搜索路径，所以相同代码可以正常运行；但VS Code默认仅将当前执行脚本所在的目录加入搜索路径，跨目录导入时就会触发ModuleNotFoundError。

方案1：修改launch.json配置（推荐，无代码侵入） #

这个方案仅对当前VS Code项目生效，不需要修改业务代码，是最方便的修复方式：

• 打开项目下的.vscode/launch.json文件
• 在你正在使用的调试配置项中，新增env字段配置PYTHONPATH，将项目根目录加入模块搜索路径
• 配置示例参考：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: 运行当前文件",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            // 新增以下配置，${workspaceFolder}对应当前VS Code打开的项目根目录
            "env": {"PYTHONPATH": "${workspaceFolder}"}
        }
    ]
}

• 如果DrivingInit.py存放在项目下的特定子目录，直接把对应目录的绝对/相对路径追加到PYTHONPATH里即可，Linux/macOS下多个路径用冒号分隔，Windows下用分号分隔。
• 改完后重启调试会话即可生效。

方案2：代码内临时添加搜索路径（适合临时调试） #

如果只是临时跑脚本不想改配置，可以在导入报错的脚本最顶部（所有import语句之前）手动把模块所在目录加入搜索路径：

import sys
# 括号内填DrivingInit.py实际存放的目录绝对路径
sys.path.append("/mnt/c/Users/hojun/Desktop/QN-Python/QNMHP_MATLAB")

注意这个方案属于硬编码路径，代码迁移到其他设备/环境时会失效，仅适合临时调试使用。

方案3：项目可编辑安装（适合长期维护的正式项目） #

如果是长期维护的项目，最规范的做法是在项目根目录编写pyproject.toml配置文件，将项目打包为可安装的Python包，之后在当前使用的Python环境中执行pip install -e .以可编辑模式安装项目。安装完成后，不管在哪个目录运行项目内的脚本，都可以正常跨目录导入模块，不需要额外配置路径。

如果配置完还是报错，可以在脚本最开头加一行print(sys.path)打印当前所有模块搜索路径，检查你存放DrivingInit.py的目录是否在输出列表中，不在的话对应调整路径配置即可。

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