必须先让右下角显示“Elixir”，否则LSP不启动、跳转定义和hover提示全部失效；需确认ElixirSyntax插件存在、语法路径正确、Sublime Text≥4142，并手动部署elixir-ls二进制。
跳转定义、hover 提示、静态分析这些功能，不是装了 LSP-elixir 插件就自动生效的——它只是客户端，真正干活的是你本地没部署或路径写错的 elixir-ls 二进制。
右下角没显示“Elixir”，LSP 根本不会启动
所有 LSP 功能都卡在这一步。打开 .ex 文件，右下角显示 Plain Text？说明 Sublime 没识别语法，后续 LSP、高亮、构建全失效。
- 点击右下角语法名 → 选
Elixir；如果菜单里没有，说明Packages/ElixirSyntax/Syntaxes/Elixir.sublime-syntax文件不存在 - 用
Preferences → Browse Packages…进入目录，确认ElixirSyntax/文件夹存在且含Syntaxes/子目录 - 别装
Phoenix-Sublime：它不提供基础.ex支持，还可能把.ex错误识别为Elixir (EEx) - 按
Ctrl+Shift+P输入Set Syntax: Elixir可手动触发，但前提是插件已正确安装
elixir-ls 不是插件，是必须手动部署的独立程序
SublimeLSP 是桥梁，elixir-ls 才是引擎。没它，右键 Go to Definition 灰掉、hover 无提示、mix format 不响应，都是必然结果。
- 推荐安装方式（需 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 - 如果报
command not found，说明没加进系统PATH，LSP 配置里就得填绝对路径，比如"/Users/you/.mix/archives/elixir-ls-release/language_server.sh" - 旧版 Sublime Text（build < 4142）无法稳定启动
elixir-ls，日志只显示client stopped unexpectedly，先升级再折腾
LSP 配置里 syntaxes 路径必须和实际语法包位置一致
哪怕 command 写对了，syntaxes 路径错一个字符，LSP 就不会绑定到当前文件——状态栏不显示图标，右键菜单也不出现语言相关项。
- 打开
Preferences → Package Settings → LSP → Servers → LSP-elixir，用户设置中填入： -
"syntaxes": ["Packages/ElixirSyntax/Syntaxes/Elixir.sublime-syntax"]（注意路径大小写和斜杠方向） - 确认当前文件真正在用
source.elixir：按Ctrl+Alt+Shift+P（Windows/Linux）或Cmd+Alt+Shift+P（macOS），输出必须是source.elixir - 如果输出是
source.eelixir或其他变体，说明语法注册失败，回到第一步检查
静态分析依赖 mix.exs 位置和项目根识别
elixir-ls 靠 mix.exs 定位项目根，进而加载依赖、编译缓存、做 Dialyzer 分析。根找错，跳转失效、未定义变量不报错、类型提示全丢。
- 确保项目根目录有
mix.exs；如果文件在子目录打开，LSP 可能误判根位置 - Sublime Text 4 build < 4142 对
mix.exs推断逻辑有硬伤，常把根设成父目录，导致deps/找不到 - 可在 LSP 用户设置里显式指定
initializationOptions，例如："rootUri": "${project_path}"，但前提是$project_path已被正确解析 - 首次启动
elixir-ls时会构建缓存，耗时较长；若中途退出，下次可能仍用旧缓存，建议删掉_build/和deps/后重试
最常被忽略的其实是版本兼容性：Sublime Text build 4142 是硬门槛，低于它连进程都拉不起来；而 elixir-ls 的 language_server.sh 路径一旦写错或权限不足，LSP 就静默失败，连错误日志都不打——得去 View → Show Console 手动翻。
