launch.json 必须正确配置为"type": "python"、"program": "${file}"，并选对解释器；watch面板依赖暂停帧作用域，右键添加变量最稳妥，但需确保断点命中且帧激活。
确保 launch.json 已正确生成并启用 Python 调试
没配置好 launch.json，监视面板就收不到变量上下文——它依赖调试会话启动时注入的运行时环境。VSCode 不会自动创建该文件，必须手动触发或通过 F5 首次调试时选择 “Python File” 才生成。
常见错误是：文件存在但 "type" 写成 "python3" 或 "debugpy"（旧写法），应统一为 "python"；"program" 值误用绝对路径或未使用 "${file}"，导致断点不生效、变量面板为空。
- 推荐最小可用配置中保留
"console": "integratedTerminal"，避免变量值在外部终端丢失上下文 - 若项目含虚拟环境，务必在 VSCode 状态栏左下角确认已选中正确的 Python 解释器（路径含
venv或.direnv） - Windows 用户注意路径分隔符不用转义，
"program": "${file}"比"./main.py"更可靠
在 Watch 面板添加表达式时要注意语法边界
Watch 面板不是 REPL，它求值依赖当前暂停帧的 Python 运行时作用域。输入 user_data 能工作，但 user_data.name 失败往往不是语法错，而是 user_data 为 None 或未定义——此时会报 ReferenceError 或空值，而非抛出 Python 异常。
容易踩的坑包括：
- 对字典用点号访问：
config.host→ 应写config['host']（除非是types.SimpleNamespace类实例） - 调用带副作用的方法：
items.pop()—— 每次刷新都会真实执行，可能破坏数据状态 - 嵌套过深且未做空值检查：
response.json()['data'][0]['id']→ 推荐改用response.json().get('data', [{}])[0].get('id') - 中文变量名或含空格字符串不能直接输入，需用引号包裹：
"用户列表"，否则解析失败
右键“添加到监视”比手输更稳，但有作用域限制
调试暂停时，把光标悬停在编辑器中的变量名上，右键选“添加到监视”，VSCode 会自动提取完整可求值路径（如 self._cache.results[2].value）。这能避开拼写错误和属性层级误判。
但这个操作只对「当前堆栈帧可见变量」有效。例如：
- 函数 A 调用函数 B，断点设在 B 中 → 可以右键添加 B 的局部变量，但无法直接添加 A 的局部变量（除非展开 Call Stack 切换到 A 的帧）
- 闭包变量（如外层函数定义、内层函数引用）可能显示为
<cell at></cell>，此时右键无效，必须手动输入nonlocal_var并确认其确实在当前帧作用域中 - 生成器对象、协程或未初始化的
__slots__属性，右键后可能显示undefined，需改用调试控制台验证
监视值不更新？先看断点是否真命中、帧是否切换
最常被忽略的一点：监视表达式只在「断点暂停瞬间」求值，单步执行（F10/F11）后不会自动刷新——必须再次暂停（走到下一个断点或手动暂停）才更新。很多人误以为它是实时流式监听。
另一个隐蔽原因：断点位于循环内，但程序跳过了该次迭代（比如条件不满足），导致你以为“卡住了”，其实是根本没命中断点。
- 确认断点右侧有实心红点，且未被禁用（灰色圆圈 = 禁用）
- 检查 Call Stack 面板顶部是否显示当前激活帧，若显示的是
<module></module>却想看函数内变量，说明断点没进函数 - 多线程/异步代码中，不同线程的变量彼此隔离，监视列表只反映当前线程暂停帧，切勿跨线程假设共享状态
