如何为VSCode交互式窗口配置默认Python搜索路径自动加载自定义包

方法1：配置工作区启动命令（最适配交互式窗口场景） #

该方法仅对当前项目生效，无需修改Python环境配置：

• 在项目根目录下新建.vscode文件夹（已存在则跳过），在文件夹内创建settings.json文件
• 在settings.json中添加如下配置：

{
    // 适配Python代码补全、静态检查的额外路径
    "python.analysis.extraPaths": [
        "/path/to/mypackage"
    ],
    // 交互式窗口启动时自动执行的命令，直接将自定义路径加入运行时搜索路径
    "python.interactiveWindow.startupCommands": [
        "import sys",
        "sys.path.append('/path/to/mypackage')"
    ]
}

如果你的包存放在项目目录内，可使用VSCode内置变量${workspaceFolder}代替绝对路径，示例：${workspaceFolder}/mypackage，跨设备使用时无需修改配置

方法2：配置.pth文件（适用于虚拟环境隔离的项目） #

如果你的项目使用独立虚拟环境，可直接修改对应环境的路径配置：

• 找到当前项目绑定的Python解释器的site-packages目录，虚拟环境路径通常为./venv/lib/python<版本号>/site-packages
• 在该目录下新建任意名称的.pth后缀文件，比如custom_pkgs.pth
• 在文件内每行写入一个要添加的自定义路径，示例：

/path/to/mypackage

配置完成后，所有使用该Python解释器的场景（包括交互式窗口、普通脚本运行）都会自动加载上述路径。如果使用全局Python解释器配置，会对所有项目生效。

方法3：配置.env环境变量（全场景生效） #

该配置同时覆盖交互式窗口、调试运行、普通脚本运行的路径搜索：

• 在项目根目录新建.env文件，写入如下内容：

PYTHONPATH="/path/to/mypackage:$PYTHONPATH"

• 在.vscode/settings.json中添加配置，指定VSCode加载该环境变量文件：

{
    "python.envFile": "${workspaceFolder}/.env"
}

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