VSCode怎么配置Elixir开发环境_VSCode ElixirLS语言服务与调试设置-VSCode-PHP中文网

ElixirLS 失效主因是本地 Erlang/Elixir 未就位或 VSCode 启动上下文错误：需在内置终端验证 elixir --version（≥1.14）、erl -version（≥25.0）、which elixir/erl 有路径；项目根须含 mix.exs 且已执行 mix deps.get；调试须用 type: "mix_task" 配置；仅保留 pguyot.erlang 和 elixir-lsp.elixir-ls 扩展并重启 VSCode。

vscode怎么配置elixir开发环境_vscode elixirls语言服务与调试设置

装完 ElixirLS 插件却没反应、跳转失效、断点不命中——八成不是插件问题，而是本地 Erlang/Elixir 没真正就位，或 VSCode 没在正确上下文中启动语言服务。

elixir --version 和 erl -version 必须在 VSCode 集成终端里能跑通

VSCode 不继承你 shell 的 PATH 就是常见死因。别只在系统终端验证，必须打开 VSCode 内置终端（Ctrl+`），执行：

elixir --version → 要输出 ≥1.14 的版本号
erl -version → 要输出 ≥25.0 的 OTP 版本
which elixir 和 which erl → 两者都得返回真实路径，不能是 command not found

Mac 用户用 asdf 时，检查 asdf current erlang 和 asdf current elixir 是否匹配预期；Windows 用户注意 PowerShell/Git Bash 下的路径是否包含 erl.exe 和 mix.bat 所在目录。

项目根目录必须有 mix.exs，且已成功执行过 mix deps.get

ElixirLS 不是全局生效的编辑器功能，它只在检测到 mix.exs 的文件夹里才拉起完整语言服务器。常见失效场景：

用 VSCode 打开的是 lib/ 子目录，上层没有 mix.exs → 补全、跳转、hover 全部降级
mix.exs 存在，但没跑过 mix deps.get → ElixirLS 卡在 “Starting ElixirLS…”，去 Output → ElixirLS 面板看第一行错误，大概率是依赖缺失或 config/config.exs 语法错
Umbrella 项目必须打开顶层根目录（含顶层 mix.exs），不是某个子应用目录

Phoenix 项目同理：mix phx.new my_app 后，直接 code . 进入该目录，别手动建空文件夹再补 mix.exs —— 缺 .formatter.exs 或 config/ 结构会导致格式化按钮灰掉。

launch.json 调试配置必须用 type: "mix_task"，且 task 字段要合法

Elixir 没有“单文件调试”概念，所有调试入口都必须是 Mix 任务。以下配置是有效起点：

VSCode

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

下载

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "mix_task",
      "request": "launch",
      "name": "phx.server",
      "task": "phx.server",
      "taskArgs": [],
      "projectDir": "${workspaceFolder}"
    }
  ]
}

关键点：

type 必须是 "mix_task"，不是 "elixir-ls" 或 "erlang"
task 值必须是真实存在的 Mix 任务（如 "test"、"run"、"phx.server"），拼错或未定义会静默失败
断点只在 lib/ 和 test/ 下生效；config/ 或 priv/ 里设断点无效
若调试时 Node.self() 返回 :nonode@nohost，说明当前是单节点无名模式——这是 mix_task 的默认行为，符合预期；需要分布式调试请换用 erlang 类型配置