如何在VSCode启动配置中引用环境变量指定Python路径？

问题分析 #

你遇到的“Python路径无效”问题，核心原因是VSCode未正确读取到~/.zshrc中配置的PROJ_VENV环境变量，或是环境变量路径在另一台机器上未对应配置。

解决方案 #

方案1：确保VSCode读取zsh环境变量 #

VSCode通过GUI启动时不会自动加载~/.zshrc，导致环境变量失效，可通过两种方式解决：

• 从终端启动VSCode：打开zsh终端，进入项目目录后执行 code .，此时VSCode会继承终端的环境变量，${env:PROJ_VENV}就能正确解析。
• 全局配置环境变量：若习惯GUI启动，将export PROJ_VENV=...移到全局配置文件（Mac用~/.zprofile、Linux用~/.profile），让GUI进程也能读取到变量。

验证方法：在VSCode终端执行 echo $PROJ_VENV，若输出正确的虚拟环境路径，说明变量已生效，launch.json配置即可正常工作。

方案2：用Poetry自动识别虚拟环境（更省心） #

无需手动维护环境变量，让VSCode直接关联Poetry虚拟环境：

1. 两台机器确保Poetry已安装，且项目pyproject.toml同步一致。
2. 打开VSCode后，按Ctrl+Shift+P（Mac为Cmd+Shift+P），输入Python: Select Interpreter，选择Poetry为当前项目创建的虚拟环境（未自动显示的话，手动输入poetry run which python的输出路径）。
3. 修改launch.json的python字段为VSCode选中的解释器路径：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Python: Django",
      "type": "python",
      "python": "${command:python.interpreterPath}",
      "request": "launch",
      "program": "${workspaceFolder}/src/manage.py",
      "args": [
        "runserver"
      ],
      "django": true
    }
  ]
}

这样两台机器只需各自选中对应Poetry虚拟环境，就能共用同一个launch.json，无需手动维护路径。

方案3：直接用Poetry命令获取路径 #

也可在launch.json中通过Poetry命令直接拉取虚拟环境路径，省去手动选择步骤：

"python": "${command:poetry env info -p}/bin/python"

注：需确保VSCode Python插件支持该命令解析，优先推荐方案2，稳定性更高。

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