如何在Visual Studio Code中完全重新定义PYTHONPATH

1. 修正终端环境变量配置（适配macOS） #

你之前错误使用了terminal.integrated.env.linux配置项，但你的系统是macOS，需替换为对应平台的配置。

在工作区的.code-workspace文件或全局~/Library/Application Support/Code/User/settings.json中添加：

"terminal.integrated.env.osx": {
    "PYTHONPATH": "/Users/me/project/utils"
}

若想通过dev.env统一管理，可先清空终端的PYTHONPATH：

"terminal.integrated.env.osx": {
    "PYTHONPATH": ""
}

2. 配置Python扩展禁用路径合并 #

修改.code-workspace中的Python扩展配置，确保仅使用指定路径：

"python.envFile": "${workspaceFolder}/dev.env",
"python.analysis.extraPaths": ["/Users/me/project/utils"],
"python.analysis.useImportHeuristic": false

说明：python.analysis.extraPaths用于代码分析时指定路径；useImportHeuristic关闭自动添加路径的启发式规则，避免额外路径被注入。

3. 验证配置有效性 #

• 重启VS Code，打开集成终端执行echo $PYTHONPATH，应仅显示/Users/me/project/utils
• 在Python代码中执行以下代码检查运行时路径：

import sys
print(sys.path)

输出的路径列表中，自定义路径仅包含你指定的内容（Python默认系统路径无法移除，但不会追加shell中的PYTHONPATH值）

额外注意事项 #

• 若zsh配置文件（.zshrc/.zprofile）中有全局PYTHONPATH设置，可通过关闭VS Code的shell环境继承来彻底隔离（谨慎使用，会禁用所有shell环境变量继承）：

"terminal.integrated.inheritEnv": false

• 若使用虚拟环境，检查虚拟环境激活脚本中是否存在追加PYTHONPATH的逻辑，如有需删除。

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