VSCode配置Elixir语言_函数式编程Phoenix框架的开发设置

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 的输出，仔细看看第一行日志说了什么。问题的答案，往往就藏在那里。