VS Code 的 code 命令不支持 --debug 等直接启动调试的参数；真正调试必须通过 launch.json 配置 + F5 触发，或手动运行 python -m debugpy 后以 attach 模式连接。
直接用 code 命令加调试参数无法开启调试会话——VS Code 的命令行启动不支持直接“启动调试”，必须靠 launch.json 配置 + F5 或调试视图触发。
为什么 code --debug 不起作用
VS Code 命令行参数里根本没有 --debug 这个开关；你搜到的类似写法基本是混淆了 Electron 启动参数或旧版文档。真实可用的调试启动路径只有一条：先打开项目/文件，再通过配置好的调试器实例触发。
-
code --help输出中完全不包含任何与“调试”“breakpoint”“attach”相关的 flag - 所谓“命令行调试”，实际是指在终端中手动启动被调试进程（如
python -m debugpy），再让 VS Code 以 attach 模式连接——这不是code命令干的事 - 想从终端一键进调试？只能靠
code .打开工作区，然后按F5，或执行code --goto定位后人工点调试按钮
code 命令能配合调试做的三件事
它不启动调试，但能帮你铺好调试前提：
- 用
code -r .强制复用已有窗口，避免多开导致launch.json配置错乱 - 用
code --folder-uri file:///path/to/project精确加载含.vscode/launch.json的工作区（尤其适合远程或符号链接路径） - 用
code --disable-extensions --log debug排查调试器插件冲突（比如 Python 扩展没加载、debugpy路径不对）
真正启动调试的最小可行路径
别纠结命令行开关，按这个顺序做才有效：
- 确保项目根目录下有
.vscode/launch.json，且至少含一个"request": "launch"配置（不是attach） - 确认
"program"字段指向正确文件，比如"${file}"或"./main.py"，不能是空或错路径 - 在目标 Python 文件里设好断点（行号左侧点击出红点），再按
F5——此时 VS Code 才会读launch.json并调用debugpy - 如果报
ModuleNotFoundError: No module named 'debugpy'，就在终端运行python -m pip install debugpy，而不是依赖全局环境
最容易被忽略的一点：launch.json 中的 "args" 只在 "request": "launch" 下生效；一旦你切到 attach 模式，所有参数都得塞进 python -m debugpy --listen ... ./script.py arg1 arg2 这条命令里——配置文件里的 args 字段彻底失效，连语法错误都不会报，只会静默忽略。
