Error Lens 插件可实现在 VSCode 中行内实时高亮错误:需安装启用插件,开启 showInlayErrors,设 gutterIconPosition 为 inline,配置 severitySortOrder 优先级,并通过 exclude 排除无关文件。

如果您在使用 VSCode 编写代码时发现错误仅显示在底部状态栏或问题面板中,缺乏行内实时高亮提示,则可能是 Error Lens 插件未启用或配置不当。以下是让错误提示更直观的多种实现方式:
本文运行环境:MacBook Air,macOS Sequoia。
一、安装并启用 Error Lens 插件
Error Lens 的核心功能依赖于插件本体的正确安装与激活,它通过监听语言服务器(LSP)报告的诊断信息,在编辑器行首和行内直接渲染错误、警告图标及文本摘要。
1、打开 VSCode,点击左侧活动栏的扩展图标(四个方块组成的图标)。
2、在扩展搜索框中输入 Error Lens,找到作者为 usernamehw 的官方插件。
3、点击“安装”按钮,安装完成后点击“重新加载”使插件生效。
二、启用行内错误文本渲染
默认情况下 Error Lens 仅显示行首的诊断图标,开启行内文本可使错误信息直接叠加在出错代码右侧,显著提升可读性。
1、按下 Cmd + , 打开设置界面。
2、在搜索框中输入 errorLens.showInlayErrors。
3、勾选该设置项,或在 settings.json 中手动添加:"errorLens.showInlayErrors": true。
三、调整错误图标位置与样式
Error Lens 支持将诊断图标从默认的行首(gutter)移至行内(inline),避免遮挡断点标记,同时支持自定义图标字符与颜色。
1、在设置中搜索 errorLens.gutterIconPosition。
2、将其值改为 inline,或在 settings.json 中添加:"errorLens.gutterIconPosition": "inline"。
3、如需更换图标,修改 errorLens.gutterIcon 值为任意 Unicode 字符,例如 "✗" 或 "●"。
四、按严重程度差异化高亮
通过配置 errorLens.severitySortOrder,可控制错误、警告、提示等不同等级诊断信息的渲染优先级与视觉权重,确保关键错误始终最醒目。
1、在 settings.json 中添加配置项:"errorLens.severitySortOrder": ["error", "warning", "info", "hint"]。
2、配合主题颜色方案,确保当前使用的 VSCode 主题对 error 级别诊断启用了强对比色背景(如红色底纹)。
五、禁用特定文件类型的诊断渲染
对于生成文件(如 dist/ 下的 JS)、Markdown 文档或配置文件,常存在大量无意义的语法警告,可针对性排除以减少干扰。
1、在 settings.json 中添加 "errorLens.exclude": ["**/dist/**", "**/*.md", "**/package-lock.json"]。
2、路径匹配遵循 glob 模式,支持双星号递归匹配,每项必须为字符串并用英文逗号分隔。










