解决Pantsbuild测试场景下VS Code内置断点失效问题

核心原因是Pants的沙箱机制会将测试代码复制到临时目录，而VS Code断点绑定的是本地原文件路径，调试器无法将临时路径和本地路径对应，导致断点不触发。下面是两种可行的解决方法：

方法一：添加路径映射（推荐） #

1. 运行你的测试命令，在终端输出中找到沙箱的临时目录路径，格式类似：Running tests in sandbox at /tmp/pants-sandbox-xxxxxx
2. 修改launch.json，在Attach Pantsbuild配置中添加pathMappings字段，将本地工作区根目录映射到沙箱目录：

{
    "version": "0.2.0",
    "inputs": [],
    "configurations": [
        {
            "name": "Attach Pantsbuild",
            "type": "python",
            "request": "attach",
            "justMyCode": false,
            "connect": {
                "host": "localhost",
                "port": 5680
            },
            "pathMappings": [
                {
                    "localRoot": "${workspaceFolder}",
                    "remoteRoot": "/tmp/pants-sandbox-xxxxxx"
                }
            ]
        }
    ]
}

注意：每次沙箱路径变化时，需要更新remoteRoot的值。临时调试直接手动替换即可，若想自动化可尝试从Pants的日志输出或环境变量中动态获取沙箱路径。

方法二：临时禁用沙箱（仅调试用） #

如果只是临时调试，不想处理路径映射，可以在测试命令中添加--no-sandbox参数，让测试直接在本地目录运行：

./pants test src/test/python/checkin/test_utils.py --test-debug-adapter --debug-adapter-port=5680 --no-sandbox -- -k test_parse_info

这种方式能直接让断点命中，但会关闭Pants的沙箱隔离，可能影响测试环境的一致性，不建议长期使用。

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