vscode离线高亮不生效的根本原因是语言模式未手动切换为log，而非网络问题；必须下载正确.vsix文件、用code --install-extension安装、再对每个日志文件右键选“log”语言模式才能激活。
VSCode 离线环境下代码高亮不生效，根本原因不是“没联网”，而是语言识别、语法规则、主题配色三者缺一不可，且全部依赖本地插件和配置——只要装对插件、路径正确、语言模式设准，完全不需要网络。
Log File Highlighter 离线安装必须用 .vsix，不是 ZIP 或源码目录
常见错误是把 GitHub 仓库 clone 下来，解压后拖进 VSCode —— 这属于开发模式加载，普通用户基本失败，报错如 Extension is not registered 或扩展根本不显示。
- 正确做法：在能联网的机器上打开
Log File Highlighter插件页，点击右下角Download Extension（不是 “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），若想匹配 error 或 info，必须改插件的 settings.json 配置项，且正则中空格、大小写、边界都要显式声明。
- 例如高亮所有小写
error：正则写成\berror\b，不能只写error（否则会匹配到errors或terror） - 忽略大小写需加
i标志：(?i)\berror\b - 匹配带空格的短语如
connection timeout，必须写成\bconnection\s+timeout\b，\s+显式表示一个或多个空白字符 - 修改后需重启 VSCode 才生效，配置项名称是
logfilehighlighter.patterns，格式为数组，每项含pattern和decorator
真正容易被忽略的点是：语言模式切换不是一次性操作，也不是靠文件后缀自动关联；哪怕你把 server.log 改成 server.txt，只要没手动切到 Log 模式，高亮就永远不会触发。
