VSCode调试核心在于正确配置launch.json并启动调试会话，断点失效主因是解释器未选对、文件未保存、状态栏语言模式错误或断点设在不可执行位置。
VSCode 调试不是“启动就跑”，而是靠断点 + 配置驱动的精确控制过程；没配好 launch.json 或选错解释器，F5 会直接报错或静默失败。
断点设置和触发失效的常见原因
断点红点显示了，但运行后根本不暂停——这通常不是 VSCode 问题，而是环境或配置没对齐：
- Python 文件没被识别为 Python：确认右下角状态栏显示
Python（而不是Plain Text），否则断点不生效 - 解释器路径错误：按
Ctrl+Shift+P→ 输入Python: Select Interpreter，选中你项目实际用的环境（如./venv/bin/python或C:\pyenv\3.11\python.exe） - 文件未保存：VSCode 默认只调试已保存的文件，
launch.json中的"program": "${file}"指向的是磁盘上当前打开的文件，未保存即运行旧版本 - 断点打在注释、空行或语法错误行：这些位置无法设有效断点，鼠标悬停时不会出现红点，或点下去立刻消失
launch.json 里必须改的三个关键字段
自动生成的 launch.json 很简陋，多数真实场景需要手动补全：
-
"args"：传命令行参数，比如调试main.py --port 8000 --debug，就写成"args": ["--port", "8000", "--debug"] -
"env"：注入环境变量，尤其对接 Flask/Django 时常用，例如"env": {"FLASK_ENV": "development"} -
"console"：默认"integratedTerminal"是最稳的选择；若要让输出出现在 Debug Console（支持print()实时刷新），可改成"internalConsole"，但某些库（如rich）可能渲染异常
完整示例片段：
{
"version": "0.2.0",
"configurations": [
{
"name": "Python: Current File",
"type": "python",
"request": "launch",
"module": "myapp.cli", // 替代 program，用于以模块方式启动（如 pip install -e . 后）
"args": ["--verbose"],
"env": {"PYTHONPATH": "${workspaceFolder}"},
"console": "integratedTerminal"
}
]
}
F10 / F11 / Shift+F11 的实际行为差异
新手常混淆“跳过”和“进入”，关键看当前行是否调用函数，且该函数是否有可调试源码：
-
F10（Step Over）：执行当前整行。如果这行是result = calculate(x, y)，它会一次性跑完calculate函数，不进内部 -
F11（Step Into）：仅当光标所在行有函数调用，且该函数源码可访问（比如不是内置函数、不是 C 扩展）时才真正进入；否则退化为F10 -
Shift+F11（Step Out）：从当前函数剩余代码一口气执行完，回到上一层调用点；但如果当前已在顶层函数（如main()），它等价于F5
注意：print()、len()、range() 这类内置操作无法 F11 进入，VSCode 会直接跳到下一行。
变量修改和 Watch 表达式的真实限制
调试时双击修改变量值很实用，但有明确边界：
- 只能改简单类型（
int、str、bool、float）和部分容器（如list元素、dict键值），不能替换整个dict或class实例 -
Watch里输入len(my_list)可实时计算，但不能赋值（my_list.append(1)会报错） - 修改变量后继续运行，新值仅影响后续逻辑；已执行过的分支（比如
if x > 5:分支）不会回滚重走
真正容易被忽略的是：**所有修改只在当前调试会话内存中生效，重启调试就还原**——它不是热重载，也不改变源文件。
