VS Code远程调试树莓派Python程序：无法查看当前调试行及断点异常

我之前也碰到过一模一样的问题！这种情况大概率是ptvsd配置不完整或者本地VS Code的路径映射没做好，咱们一步步来排查解决：

1. 确保树莓派端ptvsd代码完全生效 #

你提到已经取消了注释，但要确认代码是完整且正确的，比如：

import ptvsd
# 允许任意IP的调试连接，密钥和端口要和本地配置对应
ptvsd.enable_attach('my_secret', address=('0.0.0.0', 3000))
# 关键：让程序暂停，等待本地调试器连接（如果没加这句，程序可能直接跑过断点）
ptvsd.wait_for_attach()
# 可选：强制在某行触发断点，测试连接是否正常
# ptvsd.break()

• address用0.0.0.0可以允许本地PC连接，避免树莓派IP绑定问题；
• wait_for_attach必须加，否则程序启动后直接执行，断点根本没机会命中，自然显示灰色。

2. 本地VS Code的launch.json必须配置路径映射 #

这是最容易忽略的关键点！如果本地代码和树莓派上的代码路径不对应，VS Code找不到远程代码的本地映射，就会出现断点灰色、不高亮当前行的情况。请添加如下配置：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Remote Pi Debug",
            "type": "python",
            "request": "attach",
            "connect": {
                "host": "192.168.1.27", // 树莓派的局域网IP
                "port": 3000 // 和ptvsd设置的端口一致
            },
            "secret": "my_secret", // 和ptvsd的密钥一致
            "pathMappings": [
                {
                    "localRoot": "${workspaceFolder}", // 本地代码所在的文件夹
                    "remoteRoot": "/home/pi/your_project" // 树莓派上代码的绝对路径
                }
            ],
            "justMyCode": false
        }
    ]
}

一定要保证localRoot和remoteRoot的代码文件完全一致（文件名、目录结构都不能差）。

3. 检查树莓派的端口和防火墙 #

• 确保树莓派的3000端口没被防火墙拦截：如果开了ufw，执行sudo ufw allow 3000，或者临时关闭防火墙测试；
• 用telnet 192.168.1.27 3000测试本地PC能不能连通树莓派的3000端口，连不通的话先解决网络问题。

4. 版本兼容性检查 #

• 树莓派上更新ptvsd：pip install --upgrade ptvsd；
• 本地VS Code更新Python插件到最新版本，避免版本不匹配导致的调试异常。

5. 正确的调试流程 #

1. 先在树莓派上运行你的Python程序（此时程序会卡在wait_for_attach那行，等待连接）；
2. 在本地VS Code中选择刚才配置的Remote Pi Debug会话，启动调试；
3. 连接成功后，断点会变成红色，调试时也会高亮当前行，F10/F5等快捷键也能正常配合使用。

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