VS Code中如何为Python项目添加文件夹至搜索路径？

问题背景 #

近期从Spyder切换到VS Code进行Python项目开发，Spyder基于IPython交互式环境，但缺少代码重构等实用功能；VS Code编辑器功能更强，但配置难度较高。

项目目录结构如下：

\SysID
     |--\src
           |--\app
           |--\core
           |--\utils
           |-- config.py

项目根目录（工作区）为\SysID，可运行脚本存于\app文件夹，自定义函数存于\core和\utils文件夹，但无法直接导入。在Spyder中曾通过运行config.py配置环境路径，但VS Code每次运行脚本都会开启新Python会话，该方法失效。尝试过修改launch.json的cwd字段、settings.json配置终端环境变量、根目录创建.env文件三种方案，均未解决问题。使用Anaconda运行Spyder和VS Code，需正确配置项目搜索路径。

可行解决方案 #

方案1：通过launch.json配置调试会话的PYTHONPATH #

修改.vscode/launch.json，为Python调试配置添加env字段，直接指定模块搜索路径：

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

注意：Windows系统用分号;分隔路径，Linux/macOS用冒号:。此配置仅对调试会话生效，直接在终端运行脚本需额外配置。

方案2：将项目转为可编辑安装包（推荐规范做法） #

在项目根目录\SysID下创建setup.py文件：

from setuptools import setup, find_packages

setup(
    name="sysid_project",
    version="0.1",
    packages=find_packages(where="src"),
    package_dir={"": "src"},
)

激活对应的Anaconda环境，进入项目根目录运行：

pip install -e .

安装后，Python会自动识别src下的所有模块，无论在VS Code的哪种运行方式下，都能直接import core或import utils，无需手动配置路径。

方案3：脚本内动态添加路径（应急方案） #

在\app文件夹下的每个运行脚本开头添加以下代码，动态拼接并添加模块路径：

import sys
import os

# 从当前脚本路径向上回溯到项目根目录
project_root = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
# 添加core和utils到搜索路径
sys.path.append(os.path.join(project_root, "src", "core"))
sys.path.append(os.path.join(project_root, "src", "utils"))

该方法不依赖VS Code配置，换编辑器也能正常导入模块。

方案4：确保Anaconda环境激活 #

在VS Code集成终端中先激活对应的Anaconda环境，再运行脚本：

conda activate 你的环境名称

避免因环境不匹配导致路径配置失效。

内容的提问来源于stack exchange，提问作者Humberto Fioravante Ferro