log file highlighter 离线安装必须使用官方 .vsix 文件，不可用 zip 或源码目录；需下载正确格式文件、用 code --install-extension 命令安装，并手动将日志文件语言模式设为“log”才生效。
Log File Highlighter 离线安装必须用 .vsix，不是 ZIP 或源码目录
VSCode 只认官方打包的 .vsix 文件格式。常见错误是把 GitHub 仓库 clone 下来、解压后拖进 VSCode —— 这属于“开发模式加载”，普通用户基本会失败，报错如 Extension is not registered 或直接不显示在扩展列表里。
正确做法：在能联网的机器上，打开 Log File Highlighter 插件页，点击右下角 Download Extension（不是“Resources”里的 Repository 链接），下载到的是 emeraldwalk.logfilehighlighter-2.16.0.vsix 这类文件。
- 文件名中含版本号（如
2.16.0），建议选最新稳定版，兼容性更好 - 不要手动改后缀名：下载下来就是
.vsix，不是.VSIXPackage（那是旧版直链格式，已淘汰） - 若下载的是
.zip，说明点错了位置，重试
安装命令必须带路径，且不能有空格或中文
执行 code --install-extension 时，路径出错是离线安装失败最常见原因。VSCode 会静默失败，界面无提示，但扩展不出现。
推荐做法：
- 把
logfilehighlighter-2.16.0.vsix放到一个纯英文、无空格的路径下，比如C: six或~/vsix/ - 终端进入该目录，运行：
code --install-extension ./logfilehighlighter-2.16.0.vsix - 别用绝对路径带空格，例如
"C:My Extensionslogfilehighlighter.vsix"—— 即使加引号也常失败 - Windows 上避免放在桌面（路径含用户名可能含中文），Mac/Linux 上避免放在 iCloud 同步目录
装完不生效？90% 是语言模式没切对
Log File Highlighter 安装成功后默认不工作，因为 VSCode 不会自动把 .log、.out、server.txt 这类文件识别为日志类型。它只在语言模式为 Log（注意大小写、不是 log 或 Log File）时才激活。
必须手动设置：
- 打开日志文件 → 右键编辑器标签 → “更改语言模式” → 选择
Log - 如果菜单里没有
Log，说明插件未加载成功：重启 VSCode，再检查扩展面板是否启用（图标是蓝色而非灰色） - 每个日志文件都要单独切一次，没有全局关联配置；
files.associations对这个插件无效 - 验证是否生效：打开命令面板（
Ctrl+Shift+P），输入Log File Highlighter: Toggle，能执行即说明已就绪
自定义关键词高亮要写对正则，小写和空格都得显式处理
默认规则只匹配全大写、独立单词的 ERROR 和 WARN，真实日志里几乎都不命中。必须手动加规则到 settings.json。
关键点：
- 用
匹配单词边界，避免error_code中的error被误高亮 - 小写必须加
regexFlags: "i"，否则error不匹配 - 带空格或符号的，如
[ ERROR ]，要写成"\[\s*ERROR\s*\]"（方括号需双反斜杠转义） - 示例有效配置片段：
{
"logFileHighlighter.customPatterns": [
{
"pattern": "\b(error|warn|fatal)\b",
"regexFlags": "i",
"foreground": "#ff4444"
},
{
"pattern": "\[\s*ERROR\s*\]",
"foreground": "#ffffff",
"background": "#ff4444"
}
]
}
改完保存，不用重启，但当前日志文件需重新切一次语言模式（或关闭再打开）才能应用新规则。
长日志行要开启换行才看得全："editor.wordWrap": "on"；超大日志（>10MB）建议禁用部分规则，否则卡顿明显——这不是插件 bug，是 VSCode 渲染机制限制。
