Sublime Text配置Elixir开发环境_Sublime Text语法高亮提示教程【后端】

右下角没显示“Elixir”，这个问题是所有配置失败的根源。语法识别不了，高亮就失效；LSP不启动，代码补全就别想；构建报错，连运行都跑不起来。所以，必须先确保右下角显示Elixir、Sublime Text版本≥4142、elixir-ls正确部署且路径配置无误。

右下角没显示“Elixir”，后面所有功能都白配——高亮失效、LSP不启动、构建报错，全卡在这一步。

右下角显示 Plain Text？语法包根本没生效

打开 .ex 或 .exs 文件，发现右下角显示的是 Plain Text 或 HTML，那意味着 Sublime 根本没加载 Elixir 语法定义。问题不在插件数量，而是路径或注册失败。

• 点击右下角语法名，从弹出菜单选择 Elixir。如果列表里没有这个选项，说明 Packages/Elixir/Syntaxes/Elixir.sublime-syntax 文件根本不存在。
• 使用快捷键 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Set Syntax: Elixir。前提是 Elixir 插件已安装且路径正确。
• 通过 Preferences → Browse Packages… 进入目录，确认 Elixir/ 文件夹存在，并且里面包含 Syntaxes/Elixir.sublime-syntax。
• 千万不要装 Phoenix-Sublime 来“替代” Elixir 插件——它不提供基础 .ex 支持，还可能把 .ex 错误识别为 Elixir (EEx)，反而添乱。

Sublime Text 版本低于 4142？LSP 启动必失败

Sublime Text 4（build 4142及以上）是运行 SublimeLSP 和 elixir-ls 的硬性门槛。旧版对项目根识别、进程启动、文档链接支持极弱，elixir-ls 进程经常启动就退出，日志里只显示 client stopped unexpectedly。

• 检查版本：菜单栏 Help → About Sublime Text，确认 build 号 ≥ 4142。如果是 4126 或更早，直接升级，别在配置上浪费时间。
• 低版本下，即使填对了 command 路径，LSP-elixir 设置也大概率发灰，状态栏根本不会显示 LSP 图标。
• 旧版 SublimeLSP 对 mix.exs 位置的推断有硬伤，会把项目根设错，导致依赖无法加载、跳转全部失效。

elixir-ls 不是插件，是必须手动部署的二进制

elixir-ls 是独立语言服务器程序，不是 Sublime 插件。很多人装完 SublimeLSP 和 ElixirSyntax 就以为齐活了，结果右键没有 Go to Definition，问题就出在这里。

• 推荐方式（需 Elixir ≥ 1.12）：运行 mix archive.install github elixir-lsp/elixir-ls。成功后，在终端执行 language_server.sh --version（macOS/Linux）或 language_server.bat --version（Windows），应输出类似 ElixirLS v0.116.0 的信息。
• 手动下载：去 GitHub Releases 下载最新 elixir-ls-*.zip，解压后记下 release/language_server.sh（或 .bat）的绝对路径。
• 验证是否可用：在终端直接运行该命令，看到 Starting language server 即表示可执行。如果报 command not found，说明没加到系统 PATH，LSP 配置中就必须写全路径。
• 在 Preferences → Package Settings → LSP → Servers → LSP-elixir 的用户设置中填入："command": ["/your/absolute/path/to/language_server.sh"]。

构建系统写 "shell": true 就废了

用 "shell": true 启动 mix test 或 mix run，Sublime 会丢掉实时输出流，错误堆栈卡在半截，日志断掉就看不到哪一行报错。

• 构建命令必须用原生数组写法："cmd": ["mix", "test"]，而不是 "cmd": "mix test"。
• $project_path 必须指向包含 mix.exs 的目录。没开项目时该变量为空，命令直接失败。
• 单文件运行可用 ["elixir", "$file"]，但对 Phoenix 或任何 mix 项目完全无效——它不加载依赖、不读 config/。
• 构建系统保存为 Elixir.sublime-build，通过 Tools → Build System → Elixir 手动启用，然后按 Ctrl+B 运行。

最容易被忽略的是：语法识别和版本门槛是前置条件，不是可选项。很多人花半天调 LSP 路径，却没发现右下角一直显示 Plain Text；或者死磕构建输出，却忘了 "shell": true 让 mix 流式日志直接消失。这些点不先踩实，后续所有配置都是空中楼阁。