VS Code中Python跨模块导入的便捷配置方案咨询

针对你遇到的多模块项目导入问题，不用在每个文件加sys.path，以下是几个和PyCharm类似的便捷配置方式：

1. 用.env文件全局设置模块路径 #

在project根目录新建.env文件，写入一行：

PYTHONPATH=.

VS Code的Python插件会自动读取这个文件，把项目根目录添加到Python的模块搜索路径里，不管你运行哪个子目录里的脚本，都能直接导入同级子模块。如果怕相对路径有问题，也可以写项目的绝对路径，比如PYTHONPATH=/Users/xxx/xxx/project。

2. 配置VS Code工作区设置 #

打开VS Code的工作区设置（按Ctrl+, 切换到「工作区」标签），添加以下配置：

{
    "python.analysis.extraPaths": ["${workspaceFolder}"],
    "python.envFile": "${workspaceFolder}/.env"
}

• python.analysis.extraPaths是给VS Code的代码分析服务用的，解决代码提示里的模块找不到问题；
• python.envFile指定运行时读取的环境变量文件，确保运行脚本时路径生效。

3. 把项目安装为可编辑包（适合大型项目） #

在project根目录打开终端，执行：

pip install -e .

这会把你的项目以「可编辑模式」安装到Python环境里，相当于把项目根目录注册为Python的全局模块路径，不管在哪个目录运行脚本，都能直接导入项目里的任何子模块，和PyCharm自动识别项目根目录的逻辑一致，适合长期维护的大型多模块项目。

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