将调试配置移至code-workspace后PYTHONPATH无法识别

问题背景 #

工作区结构如下：

folder1
 |_ .vscode
      |_ launch.json
folder2
 |_ .vscode
      |_ launch.json

原本在folder2的.vscode/launch.json中配置调试项时，通过PYTHONPATH: "${workspaceFolder}/../folder1"可以正常单步调试folder1内的代码。将该调试配置迁移到code-workspace文件后，PYTHONPATH无法被识别，导致无法进入folder1的代码调试。

迁移后的code-workspace中launch配置片段：

"launch": {
    "configurations": [
        {
            "name": "Debug Unit test",
            "type": "python",
            "request": "launch",
            "justMyCode": true,
            "purpose": [
                "debug-test"
            ],
            "env": {
                "PYTHONPATH": "${workspaceFolder}/../folder1"
            }
        }
    ],
    "compounds": []
}

问题原因 #

在单个文件夹的.vscode/launch.json中，${workspaceFolder}指向当前文件夹（即folder2）；但在code-workspace文件中，${workspaceFolder}默认指向工作区根目录（而非单个子文件夹），导致路径计算错误，PYTHONPATH无法正确指向folder1。

解决方案 #

方案1：明确指定子文件夹路径变量 #

用${workspaceFolder:folder2}精准指向folder2的路径，保留原路径逻辑：

"env": {
    "PYTHONPATH": "${workspaceFolder:folder2}/../folder1"
}

方案2：直接引用folder1的工作区路径 #

如果code-workspace已将folder1添加为工作区文件夹，可直接用${workspaceFolder:folder1}设置PYTHONPATH：

"env": {
    "PYTHONPATH": "${workspaceFolder:folder1}"
}

需确保code-workspace文件已正确包含两个文件夹：

{
    "folders": [
        {
            "path": "folder1"
        },
        {
            "path": "folder2"
        }
    ],
    "launch": {
        // 调试配置内容
    }
}

方案3：简化为相对工作区根的路径 #

若code-workspace文件与folder1、folder2处于同一父目录，可直接简化路径：

"env": {
    "PYTHONPATH": "${workspaceFolder}/folder1"
}

验证方式 #

启动调试后，在调试控制台执行以下代码，确认folder1路径已在输出列表中：

import sys
print(sys.path)

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