Watch面板仅在调试会话中生效，必须按F5启动调试或点击Run and Debug侧边栏的绿色三角形，并确保有正确的launch.json配置；未进入调试模式则无法使用。

Watch 面板只在调试会话中生效，不是“运行”就能用

VSCode 的 Watch 面板根本不会响应“运行”（Ctrl+F5）或终端执行命令——它只依赖调试器提供的上下文。没看到面板？先确认顶部状态栏有没有橙色调试工具条（含暂停、继续按钮）。没有？说明你压根没进调试模式。

必须按 F5 启动调试，或点击侧边栏 Run and Debug → 点绿色三角形；确保项目下有有效的 .vscode/launch.json，且其中 "type": "python"（或其他对应语言）配置正确。

• 按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（Mac）→ 输入 Debug: Toggle Watch → 回车，可强制唤出面板
• 面板被折叠？点右上角三个点 → 选 Show Watch
• 如果仍为空白，检查是否在断点暂停状态下操作；未暂停时 Watch 不刷新也不显示值

添加表达式后显示 “Cannot evaluate” 或 undefined

这不是语法错误，是作用域或执行时机不匹配。Watch 表达式是在当前断点所在的栈帧里求值的，超出可见范围就拿不到。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 在函数 A() 里设断点，却往 Watch 里输 B().local_var → 报 Cannot evaluate
• 异步回调里的变量（如 threading.Thread(target=...) 或 asyncio.create_task(...) 中定义的）在主线程断点处无法访问 → 把断点移到回调函数内部再加 Watch
• 拼错变量名或大小写不符（userName vs username）→ 不报错，只显示 undefined
• 访问 obj.attr 失败？确认 obj 是实例对象，且 attr 不是 @property 或自定义 __get__，否则 debugpy 可能返回 Unable to get repr for <>

Watch 和 Debug Console 的行为本质不同

很多人误以为 Watch 能执行赋值，结果发现没反应——因为它是只读快照，而 Debug Console 是可执行 REPL。

• 在 Watch 里输 i = i + 1 → 没效果，甚至报错；它不执行，只尝试求值
• 在 Debug Console 里输同样内容 → i 真的被修改，副作用立即生效
• Watch 适合盯住某个值的变化（比如循环中 total 和 item），但别写耗时操作：[x for x in huge_list if x > 10] 每次刷新都会重算
• Watch 支持简单表达式：data[0].name、len(items)，但不自动感知依赖变化，它只反映“当前断点暂停那一刻”的栈帧快照

变量值看起来空，但其实只是没展开对的地方

“变量”面板只列出当前栈帧可见的局部/全局变量，闭包变量、尚未声明的 let/const、或异步回调中的变量可能不出现。

• 鼠标悬停在变量名上，往往比“变量”面板更可靠，尤其对临时表达式或深层属性
• 在 Debug Console 里手动输入 typeof myVar 或 myVar?.toString()，可绕过作用域限制强行求值
• 对大型对象，右键 → 复制值，粘贴到 Debug Console 再用 JSON.stringify(obj, null, 2) 格式化（注意：不能用于函数、Date、DOM 节点等非序列化类型）
• 监视数组前几项：用 arr.slice(0, 5)，避免一次性展开全部导致卡顿

Watch 面板本身不复杂，但它的有效性完全绑定在断点位置、作用域边界和调试器状态上——这些细节一旦错位，它就变成一个安静的摆设。