Docker容器内Python服务VS Code远程调试侧边栏断点无法触发求助

我正在开发一个运行于Docker容器中的服务器应用，该应用等待调试器远程连接。目前遇到的问题是：仅通过添加额外代码设置的断点（图1）能够被触发，但通过点击代码侧边栏设置的常规断点（图2）无法触发。已花费大量时间尝试解决但毫无进展，寻求帮助。

使用环境：

• VS Code v1.74.3
• Python v3.8.10
• VS Code Python扩展v2022.20.2

以下是launch.json的相关配置：

{
    "name": "Backend attach (Docker)",
    "type": "python",
    "request": "attach",
    "host": "localhost",
    "port": 5678,
    "pathMappings": [
        {
            "localRoot": "${workspaceFolder}/Backend/Src/app",
            "remoteRoot": "/home/backend-server/app"
        }
    ]
}

可能的解决方法 #

1. 核对路径映射准确性 #

确认pathMappings里的localRoot和remoteRoot完全匹配容器内代码的实际路径。可以进入容器执行pwd查看代码目录，或者检查容器启动时的挂载命令——Linux容器区分大小写，本地如果是Windows/macOS系统可能不区分，这点很容易踩坑。

2. 保证本地与容器代码完全同步 #

本地代码和容器内的代码必须内容、版本完全一致。如果本地改了代码但没同步到容器，调试器找不到对应行的代码，常规断点自然失效。建议用卷挂载实时同步代码，或者每次修改后重新构建镜像。

3. 配置debugpy的路径映射 #

如果容器内用debugpy启动应用，除了VS Code的配置，还可以在代码里手动设置路径映射：

import debugpy
debugpy.listen(('0.0.0.0', 5678))
debugpy.wait_for_client()
# 手动添加路径映射
debugpy.configure({"pathMappings": [{"localRoot": "/本地实际路径/Backend/Src/app", "remoteRoot": "/home/backend-server/app"}]})

4. 关闭"Just My Code"设置 #

在launch.json里添加"justMyCode": false，这个设置有时会干扰断点识别：

{
    "name": "Backend attach (Docker)",
    "type": "python",
    "request": "attach",
    "host": "localhost",
    "port": 5678,
    "pathMappings": [
        {
            "localRoot": "${workspaceFolder}/Backend/Src/app",
            "remoteRoot": "/home/backend-server/app"
        }
    ],
    "justMyCode": false
}

5. 检查版本兼容性 #

尝试更新VS Code的Python扩展到最新版，或者回退到更稳定的版本，版本不匹配偶尔会导致调试功能异常。

6. 确认断点位置有效性 #

常规断点要设置在可执行代码行上，别放在注释、空行或者函数定义行（要选函数内部的执行代码）。另外检查代码逻辑，确保断点所在的分支确实会被执行到。

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