Sublime需手动配置Zig语法支持、构建系统、语言服务器及调试选项：安装Zig Language插件并设语法；新建Zig.sublime-build文件定义构建命令；用LSP插件集成zls实现补全跳转；调试需加-fno-strip -g参数并配合sublime-debugger或改用VS Code。
安装 Zig 编译器后，Sublime 无法识别 zig 文件类型
Sublime 默认不带 Zig 语法支持，打开 .zig 文件就是纯文本，没有高亮、括号匹配或缩进规则。这不是插件问题，而是连基础语法定义都没加载。
- 手动设置：打开文件 → View → Syntax → Open all with current extension as… → Zig（如果已装插件）
- 更稳妥的做法是先装
Zig语法包：用 Package Control 安装Zig Language（作者是mitchellh，别选错成ZigLang或其他变体） - 装完重启 Sublime，或手动执行
Ctrl+Shift+P→Set Syntax: Zig - 若仍无效，检查
Packages/Zig Language/syntaxes/Zig.sublime-syntax是否存在——缺失说明安装失败，重装即可
想用 ctrl+b 快捷键构建 Zig 项目，但报错 Unable to find target
Sublime 的构建系统默认只认 Makefile 或 go build 这类约定俗成的命令，Zig 没内置支持，必须手写 .sublime-build 配置。
- 新建构建系统：
Tools → Build System → New Build System…，粘贴以下内容并保存为Zig.sublime-build - 关键字段不能错：
"cmd"要用绝对路径或确保zig在$PATH中；"selector"必须是source.zig（对应语法包定义） - 推荐配置（适配常见场景）：
{
"cmd": ["zig", "build", "--summary"],
"file_regex": "^(.*):([0-9]+):([0-9]+): (error|warning): (.*)$",
"selector": "source.zig",
"working_dir": "${project_path:${folder}}"
}
- 注意：
zig build依赖项目根目录下有build.zig；如果只是单文件测试，改用["zig", "run", "$file"]更直接 - Windows 用户需把
zig换成zig.exe，否则可能提示命令未找到
代码补全和跳转失效，goto definition 提示 “No definition found”
Sublime 原生不提供 Zig 的语义分析能力，所谓“补全”和“跳转”必须靠外部工具驱动，目前最稳定的是 zls（Zig Language Server）。
- 先装
zls：运行zig build -Drelease-safe编译它（官方推荐），或从 GitHub Releases 下载预编译二进制 - 再装 Sublime 插件：
LSP（不是SublimeLSP，后者已弃用），然后配置LSP-zig子插件 - 重点检查
zls路径是否正确：在LSP.sublime-settings里确认"zls"对应的"command"是完整路径，比如"/opt/zig/zls"，不能只写"zls" - 启动 LSP 后，首次打开项目会卡几秒——这是 zls 在扫描依赖，别急着关掉；若持续无响应，看 Sublime 控制台（
Ctrl+`）是否有connection refused类错误，大概率是zls没跑起来
调试 Zig 程序时，断点不生效或变量显示 <optimized out></optimized>
Sublime 本身不带 Zig 调试器，得靠 lldb 或 gdb 配合 sublime-debugger 插件，而 Zig 默认生成优化代码，调试信息会被剥离。
- 构建时必须加
-fno-strip -g：例如zig build-exe main.zig -fno-strip -g，否则调试器看不到变量值 -
sublime-debugger插件对 Zig 支持有限，更可靠的方式是用 VS Code +zls+CodeLLDB做调试，Sublime 专注写码和轻量构建 - 如果坚持用 Sublime，可临时用
std.debug.print替代断点——Zig 的打印开销极低，且不会干扰控制流，比折腾调试器更省时间
Zig 生态还在快速演进，zls 的协议兼容性、Sublime 插件的更新节奏、甚至 zig build 的参数变动都可能导致某天突然失灵。遇到问题优先查 zls 日志和 Sublime 控制台输出，而不是反复重装插件。
