VS Code命令行调试Python程序的参数与断点问题求助

问题1：命令行调试（attach模式）下launch.json的args参数被忽略 #

在attach（附加）调试模式下，VS Code的launch.json里的args参数完全不生效。核心原因是：attach模式是连接一个已经启动的Python进程，而进程的启动参数（包括sys.argv）在进程启动瞬间就已经确定，VS Code无法在附加后修改已运行进程的启动参数。

正确的做法是：在终端启动debugpy时，直接把参数追加到命令末尾，比如：

python -m debugpy --listen 0.0.0.0:5678 ./test.py parameter1 parameter2

这样启动的进程会自动将parameter1和parameter2作为sys.argv[1]和sys.argv[2]，程序就能正常读取参数。

问题2：命令行调试时断点无法生效 #

断点不生效通常由以下原因导致，按优先级排查：

1. 进程未等待调试客户端连接
   如果启动命令没加--wait-for-client，进程会直接开始执行，你的test.py代码很短，可能在你点击VS Code的附加按钮前，程序已经运行完毕。必须添加该参数让进程暂停，等待VS Code连接：

   python -m debugpy --listen 0.0.0.0:5678 --wait-for-client ./test.py parameter1 parameter2
   

2. 文件路径映射不匹配
   VS Code中打开的文件路径和终端运行的文件路径可能存在差异（比如Windows盘符大小写、相对路径/绝对路径不统一），导致debugpy无法关联VS Code里的断点。解决方法：
   • 启动debugpy时使用文件的绝对路径，比如：

     python -m debugpy --listen 0.0.0.0:5678 --wait-for-client C:\你的项目路径\test.py parameter1 parameter2
     

   • 在launch.json的attach配置中添加pathMappings字段，明确映射本地路径和进程运行路径：

     {
         "name": "Python Debugger: Attach",
         "type": "debugpy",
         "request": "attach",
         "connect": {
             "host": "localhost",
             "port": 5678
         },
         "pathMappings": [
             {
                 "localRoot": "${workspaceFolder}",
                 "remoteRoot": "."
             }
         ]
     }
     

3. 版本兼容性问题
   当前使用的debugpy版本（24.077.775）和Python 3.12.3可能存在兼容性冲突，可尝试降级到稳定版debugpy：

   python -m pip install debugpy==1.8.1
   

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