ElixirLS 启动失败、Phoenix 模板无高亮、断点不命中，根本原因是底层环境或配置未对齐项目上下文
ElixirLS 启动失败，Phoenix 模板没高亮，断点不命中——根本原因不是插件装得不对，而是底层环境或配置没对齐项目上下文。
elixirLS 启动失败：先查 erl 和 elixir 命令是否真可用
VSCode 里的 ElixirLS 本质上是一个“语言服务器”，它本身并不携带 Erlang/OTP 或 Elixir 的运行时环境。所以，一旦你系统里的 erl 或 elixir 命令在终端里执行报错、版本过低、或者路径被 asdf、chruby 这类版本管理器给“遮蔽”了，ElixirLS 就会卡在 “Starting…” 的状态，Output 面板里只会留下一句冷冰冰的 Failed to start language server。
- 第一步，务必在终端里分别运行
erl -version和elixir --version，确保两者都能输出有效版本（建议 Erlang ≥ 25.0，Elixir ≥ 1.14）。 - 对于 Mac Apple Silicon 用户，如果用 Homebrew 安装，PATH 通常指向
/opt/homebrew/bin；如果使用 asdf，请确认在当前 shell 中已经执行过类似asdf local erlang 15.0和asdf local elixir 1.17-otp-25的命令来锁定版本。 - Windows 用户通过 Chocolatey 安装时需要注意，
choco install erlang后生效的命令是erl，而非werl；而elixir包会自动将mix加入 PATH。这两个命令缺了任何一个，都可能导致启动失败。
Phoenix 模板文件（.eex/.leex）不识别为 Elixir 代码
VSCode 默认会把 .eex 文件当作普通的 HTML 来处理，结果就是模板里的嵌入式表达式 既不高亮，也无法跳转，格式化更是无从谈起。这其实不是插件本身的问题，而是文件类型关联没有设置正确。
- 按下
Cmd+Shift+P（Windows/Linux 是Ctrl+Shift+P），调出命令面板，输入并选择Preferences: Configure File Association。 - 然后依次操作：输入
*.eex→ 选择elixir；输入*.leex→ 选择elixir；输入*.html.eex→ 同样选择elixir。 - 完成设置后，关掉再重新打开一个
.eex文件，观察左下角的状态栏。这里必须显示为Elixir，而不是HTML或Plain Text。 - 如果仍然无效，不妨检查一下工作区的 settings.json 文件，看看是否有冲突的配置项，比如
"files.associations"里被硬编码了"*.eex": "html"这样的规则。
launch.json 调试配置不生效：mix_task 类型必须匹配 Phoenix 启动方式
直接从网上复制旧的调试配置模板，很容易在这里踩坑。Phoenix 项目不能简单地用 mix run 来启动调试，必须使用 phx.server 任务，并且需要显式指定 projectDir 和环境变量，否则断点永远不会被触发。
- 按下
Cmd+Shift+P，输入Debug: Open launch.json，选择Elixir环境来生成一个基础模板。 - 将内容替换为以下配置（关键点：
projectDir必须指向当前工作区的根目录，而不是某个子目录）：
{
"version": "0.2.0",
"configurations": [
{
"type": "mix_task",
"name": "phx.server",
"request": "launch",
"projectDir": "${workspaceFolder}",
"task": "phx.server",
"taskArgs": [],
"env": {
"MIX_ENV": "dev"
}
}
]
}
- 确保项目根目录下存在
mix.exs文件，并且已经执行过mix deps.get来获取依赖。否则，ElixirLS 无法加载完整的项目上下文，调试器自然也就找不到模块定义。 - 另外需要了解的是，断点只在
.ex文件的函数体内生效。在.eex模板里设置断点是无效的，调试模板逻辑时，可以改用IO.inspect/1输出，或者在对应的 controller action 里打断点。
mix formatOnSa ve 不起作用：检查项目级配置和文件扩展名
很多人明明开启了 elixir.formatOnSa ve 设置，保存文件时却发现没有任何格式化效果。常见的原因有两个：要么是 VSCode 没有识别出当前文件属于一个 Elixir 项目，要么是文件的后缀名不被 mix format 支持。
- 首先确认，当前打开的文件路径位于包含
mix.exs的目录之下（即${workspaceFolder}）。如果不在项目根目录或子目录内，VSCode 可能不会应用项目级的格式化设置。 - 其次，自动格式化通常只对
.ex、.exs文件生效。对于.eex和.leex模板文件，目前并不支持（事实上，Phoenix 官方也不推荐在模板中编写复杂的逻辑）。 - 如果以上都确认无误仍不生效，可以尝试在终端手动运行
mix format，看看是否有报错信息。一个常见的原因是项目根目录缺少.formatter.exs配置文件，或者mix.exs中没有声明format: [...]配置段。 - 作为临时解决方案，可以在 settings.json 中添加一行配置来强制启用：
"[elixir]": { "editor.formatOnSa ve": true }。
最后，有一个最容易被忽略的细节：ElixirLS 的启动，严格依赖于 mix.exs 文件的存在且能被成功解析——哪怕文件中只有一个微小的语法错误，都可能导致整个语言服务静默失败，连个错误提示都不会弹出来。所以，当你遇到问题时，先别急着重装插件，不妨打开 Output 面板，切换到 ElixirLS 的输出，仔细看看第一行日志说了什么。问题的答案，往往就藏在那里。
