如何在VSCode单步调试模式中开启内联值显示直接在编辑器代码旁边看变量当前值

如何在VSCode单步调试模式中开启内联值显示直接在编辑器代码旁边看变量当前值

想在调试时，直接在代码行旁边看到变量的当前值，而不是总去侧边栏或控制台里翻找？这个功能确实能极大提升效率。但先明确一个核心前提：必须手动开启 debug.inlineValues 这个全局开关，并且你使用的调试器必须支持 DAP v1.67+ 协议。 仅仅安装扩展或者打上断点，是绝对不会自动生效的。

确认 debug.inlineValues 已启用

这是整个功能的总开关，VSCode 默认是关闭的。换句话说，就算你用的是最新版的调试器，只要这个配置项是 false，编辑器右侧就绝不会出现那些黄色的变量值提示。

怎么打开它？其实很简单：

• 最快捷的方法：按下 Ctrl+,（Windows/Linux）或 Cmd+,（macOS），在设置搜索框里直接输入 debug inline values。
• 找到 Debug: Inline Values 这个选项，确保前面的复选框已经被勾选（对应的值变为 true）。
• 这个设置是全局生效的，不需要在每个项目里重复配置。修改后也无需重启VSCode，下一次启动调试会话时，改动就会立即生效。

检查调试器是否满足 DAP v1.67+ 协议要求

光有开关还不够。内联值显示这个功能，依赖于调试适配器协议（DAP）的特定能力。版本过老的调试器，会直接无视这个配置。这里有个常见的误区：不是“我装了Python扩展就行”，关键要看扩展底层使用的调试器库版本是否达标。

• Python 开发者：需要确保 debugpy 的版本 ≥ 1.8.0。可以在终端运行 pip show debugpy 来验证。如果版本低于这个要求，就算你在设置里勾选了，调试时也不会有任何反应。
• Node.js / TypeScript 开发者：这个功能依赖VSCode内置的 js-debug 调试器。通常，VSCode 1.85版本之后都会自带符合条件的版本。但如果你手动禁用了它，或者回退到了旧版，就需要检查并重置调试器配置。
• 其他语言（如Go、C#等）：原理相同。需要查阅对应调试扩展的更新日志，确认其明确标注了“支持内联值显示”或“兼容 DAP v1.67+”。

避开常见失效场景

好了，开关打开了，调试器版本也够新，可为什么还是看不到内联值？问题大概率出在下面这几个容易被忽略的细节上。

• 只在单步调试暂停时显示：这是最关键的一点。内联值只在你按下 F10（逐过程）或 F11（逐语句）并停住的时候才会出现。如果程序正在运行，或者根本没有命中断点，代码旁边空白一片是完全正常的。
• 复杂表达式不支持：这个功能主要服务于快速查看。因此，像 arr.map(x => x * 2)[0] 这类复杂表达式，或者带有副作用的函数调用（如 func()），通常不会进行内联计算和显示。它主要支持简单的变量名、属性访问（如 user.name）和数组索引（如 list[0]）。
• Source Map错位问题：在TypeScript或Webpack打包的项目中，如果Source Map配置有误，可能会导致源码与生成代码的行号对不上。结果就是，内联值可能会“挂”在错误的行旁边。确保你的 launch.json 配置中 sourceMaps: true 已开启，并且 outFiles 路径能正确匹配到生成的文件位置。
• 主题或字体设置冲突：有时候，你使用的编辑器主题或自定义字体设置，可能会意外地裁剪掉内联提示的文字。如果怀疑是这个问题，可以尝试临时切换到 Default Dark+ 这类默认主题，并检查设置中 editor.inlayHint.padding 是否为 true，以确保有足够的显示空间。

验证是否真生效的小技巧

怎么判断功能真的起作用了？别只盯着断点所在的那一行看。这里有个实用技巧：

把光标停在一行有变量赋值的代码上（比如 const count = items.length;），然后按 F10 单步执行到下一行。此时，count 的值才会以内联文本的形式，出现在上一行代码的末尾。

很多人会误以为“停在赋值行时，它就应该显示出来”。其实不然，内联值是在后续执行到能访问该变量的作用域时，才会被渲染出来。另外，它通常不会显示在 console.log 语句或者函数调用行旁边，也不会显示当前闭包外无法访问的变量。本质上，它提供的是当前栈帧内、静态作用域可推导出的变量值的一个快照。