Zig文件显示Plain Text是因语法未绑定，非插件问题；需手动Ctrl+Shift+P→Set Syntax: Zig，或View→Syntax→Open all with current extension as…→Zig，禁用过时zig-mode，确保使用Sublime Text 4内置Packages/Zig/Zig.sublime-syntax。
Zig 文件在 Sublime Text 里显示为纯文本？不是插件没装，是语法绑定根本没生效——Sublime Text 4 已内置 Zig.sublime-syntax，但默认不自动关联 .zig 后缀，必须手动触发或修复映射。
右下角显示 “Plain Text” 怎么办
这是最直接的失效信号，说明 Sublime 连基础识别都没做，和高亮主题、插件冲突都无关。
- 先按
Ctrl+Shift+P（macOS 是Cmd+Shift+P），输入Set Syntax: Zig回车——如果列表里有Zig，说明内置语法已就位，只是没自动绑定 - 若没有
Zig选项，检查Packages/Zig/Zig.sublime-syntax是否存在（路径在Preferences → Browse Packages打开）；缺失说明 Sublime 版本过旧或损坏，需重装 Sublime Text 4 - 别点
ZigLang或zig-mode：前者是第三方旧包，后者最后更新于 2020 年，会覆盖内置语法，导致nosuspend、async、///文档注释全不着色
为什么装了 Zig Language 插件还是不亮
因为 Zig Language（作者 mitchellh）插件本身已过时，且与 Sublime Text 4 内置语法冲突。官方明确推荐弃用它，改用原生 Packages/Zig/ 路径下的语法定义。
- 如果你已安装
Zig Language或zig-mode，请立刻禁用或卸载：Preferences → Package Settings → Package Control → Disable Package - 重启 Sublime 后再试
Set Syntax: Zig；若仍无效，手动绑定一次：View → Syntax → Open all with current extension as… → Zig - 验证是否生效：新建文件，保存为
test.zig，输入const x = comptime 1 + 1;——comptime应高亮为关键字，括号应匹配，缩进自动对齐
构建系统报 command not found: zig
Sublime 启动时不会继承 shell 的 PATH，尤其 macOS 从 Dock 启动、Windows 未设系统环境变量时，终端能跑 zig version，但 Ctrl+B 就失败。
- macOS 用户必须用终端启动：
open -a "Sublime Text"，否则 zls 和构建命令都会找不到zig - Windows 用户要把
zig.exe所在目录（如C:\zig\）加进「系统属性 → 高级 → 环境变量 → PATH」，然后彻底关闭并重启 Sublime - 兜底方案：写死绝对路径，在
Tools → Build System → New Build System…中填：{ "cmd": ["/opt/homebrew/bin/zig", "run", "$file"], "selector": "source.zig" }注意selector必须是source.zig，否则构建系统不触发
zls 补全和跳转始终不工作
语法高亮 ≠ 智能支持。@import 跳转失败、comptime 字段不提示、@compileLog 不输出，这些全依赖 zls（Zig Language Server），不是靠语法插件。
-
zls必须独立安装：从源码编译（zig build -Drelease-safe -Denable-zls）或下载匹配 Zig 版本的预编译二进制（如 Zig 0.12.0 对应 zls 0.12.x） - 必须配
LSP插件（不是SublimeLSP，后者已弃用），在Preferences → Package Settings → LSP → Settings中添加："clients": { "zig": { "command": ["/path/to/zls"], "scopes": ["source.zig"], "syntaxes": ["Packages/Zig/Zig.sublime-syntax"] } } - 首次打开项目时 zls 会扫描依赖，控制台卡几秒正常；若持续无响应，看 Sublime 控制台（
Ctrl+`）是否有connection refused或zls exited with code 1——大概率是zls路径错、权限不足，或 Zig 版本不匹配
