log file highlighter 需手动设置语言模式为“log”才能启用高亮；默认不识别.log等后缀，error/warn需自定义正则并加i标志；长行需开启wordwrap:on；大文件应禁用冗余规则或改用log viewer流式查看。
Log File Highlighter 装完不会自动高亮，核心卡点就一个：语言模式没切对。
为什么日志文件打开后还是纯文本？
VS Code 不会根据 .log 后缀自动把文件识别为日志类型——尤其当文件是 app.out、server.txt 或通过重定向生成（如 npm run dev > log.txt）时，默认语言模式是 Plain Text，插件完全不触发。
- 必须手动右键编辑器标签 → “更改语言模式” → 选
Log（注意不是Log File或log，大小写敏感） - 如果菜单里没出现
Log，说明插件未激活，或文件路径含空格/中文/特殊符号导致加载失败 - 批量打开多个日志？每个文件都要单独切一次语言模式，没有全局开关
- 重启 VS Code 不能替代这一步，只解决插件没加载的问题
ERROR/WARN 不高亮？检查正则匹配逻辑
默认规则只认全大写、无空格、独立单词的 ERROR 和 WARN。但真实日志常有：error（小写）、[ ERROR ]（带空格和括号）、ERR:（前缀）、err_code=500（嵌在字段里）——这些全都不命中。
- 在
settings.json中加自定义规则，例如："pattern":"\b(error|warn|fatal)\b","regexFlags":"i" -
regexFlags: "i"必须显式写上，否则小写不匹配 - 用
\b（单词边界），避免把error_code里的error单独高亮 - 匹配带空格的
[ ERROR ]，要写成"\[\s*ERROR\s*\]"，注意方括号需转义
怎么让长日志行不被截断？
日志里关键字段如 trace_id、完整 URL、堆栈路径动辄超百字符，VS Code 默认关闭软换行，横向滚动极易漏信息——这不是插件问题，是编辑器基础设置。
- 临时开启：按
Alt+Z（Win/Linux）或Option+Z（Mac） - 永久生效：在
settings.json加"editor.wordWrap": "on" - 别用
"wordWrap": "bounded"，它按固定列数硬截断，反而更难读 - 开启后，像
127.0.0.1 - - [27/May/2026:03:18:00 +0000] "GET /api/v1/users?id=1234567890abcdef...这种长行会自动折行，关键参数不再消失
大文件卡顿怎么办？
Log File Highlighter 对单文件性能无硬限制，但超过 5 万行后，实时高亮+正则扫描会明显拖慢响应——尤其开了多个自定义规则时。
- 优先用
Ctrl+Shift+F正则搜索定位问题段，再局部打开查看，别硬扛全量加载 - 禁用非必要规则：比如你只关心错误，就把
INFO、DEBUG相关的高亮规则注释掉 - 确认文件是否真需要编辑：只是看日志？用
Log Viewer插件的Tail -f this file流式读取更轻量 - 真正影响体验的，往往不是插件本身，而是忘了关掉
editor.renderWhitespace或editor.glyphMargin这类视觉增强项
