VSCode配置Elixir语言_函数式编程Phoenix框架的开发设置-VSCode-PHP中文网

elixirls 启动失败、phoenix 模板无高亮、断点不命中，根本原因是底层环境或配置未对齐项目上下文：erl/elixir 命令不可用或版本过低；.eex/.leex 文件未正确关联为 elixir 类型；调试需用 phx.server 而非 mix run，且 projectdir 必须指向含 mix.exs 的根目录。

vscode配置elixir语言_函数式编程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 处理，结果嵌入式表达式不高亮、跳转失效、无法格式化。这不是插件问题，是文件类型绑定没改。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

按 Cmd+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 formatOnSave 不起作用：检查项目级配置和文件扩展名

很多人开了 elixir.formatOnSave 却发现保存后没格式化，常见原因是 VSCode 没识别当前文件属于 Elixir 项目，或者文件后缀不被 mix format 支持。

确保当前打开的文件路径在含 mix.exs 的目录下（即 ${workspaceFolder}），否则 VSCode 不启用项目级设置
只对 .ex、.exs 文件生效；.eex 和 .leex 不支持自动格式化（Phoenix 官方也不推荐在模板里写复杂逻辑）
若仍无效，手动运行 mix format 看终端是否报错，常见原因是 .formatter.exs 缺失或 mix.exs 中未声明 format: [...] 配置段
可临时加一行到 settings.json 强制启用："[elixir]": { "editor.formatOnSave": true }