如何为所有脚本程序化添加项目根目录到Python导入路径？

1 调整VS Code调试配置（解决IDE内运行/调试问题） #

你当前的launch.json配置缺失Python包搜索路径的指定，修改为以下配置即可：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Current File",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "justMyCode": true,
            "cwd": "${workspaceFolder}",
            "env": {
                "PYTHONPATH": "${workspaceFolder}"
            }
        }
    ]
}

配置中PYTHONPATH会把项目根目录临时加入Python的包搜索路径，cwd确保运行时的工作目录固定为项目根目录，原配置里的"-m"参数属于错误配置，直接移除即可。

2 项目级通用方案（兼容所有运行场景、跨机器可用） #

在项目根目录创建pyproject.toml配置文件，写入基础的项目元信息：

[build-system]
requires = ["setuptools>=61.0"]
build-backend = "setuptools.build_meta"

[project]
name = "你的项目名"
version = "0.1.0"

之后在项目根目录执行pip install -e .，这个命令会将当前项目以可编辑模式安装到Python环境的包搜索路径中，所有跨目录导入都可以直接生效，不需要修改任何代码，换机器运行只要在对应环境执行一次安装命令即可。

3 临时终端运行方案 #

如果不想修改配置也不想安装，运行脚本时主动指定PYTHONPATH环境变量即可：

• Linux/macOS终端：

  PYTHONPATH=$(pwd) python script_folder/s1.py
  

• Windows cmd：

  set PYTHONPATH=%cd% && python script_folder\s1.py
  

• Windows PowerShell：

  $env:PYTHONPATH=$PWD.Path; python script_folder\s1.py
  

补充说明：为什么__init__.py里加路径不生效 #

init.py只有在对应包被成功导入时才会执行，你遇到的问题是Python在导入阶段就找不到顶层包，根本不会执行到__init__.py里的代码，所以这个方案不可能生效。

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