如何通过vscode进行Elixir语言开发与调试【教程】

安装Elixir和erlang是调试前提，需用asdf（mac）、官方安装包（win）或源码编译（linux）确保版本兼容；启用ElixirLS插件并打开含mix.exs的根目录；launch.json须配置mix task模式；断点失效主因是未编译、模块未加载或编码问题。

安装 Elixir 和 Erlang 运行时是调试的前提

vs code 本身不提供 Elixir 运行能力，elixir 和 erlang 必须提前装好，否则所有插件都会报错或无法启动调试器。Mac 用户用 asdf 最稳妥，windows 用户推荐官方 otp_win64.exe + elixir-windows-setup.exe 组合；Linux 用户避免用系统包管理器（如 apt install elixir），容易装到过旧版本。

验证是否就位：

elixir --version erl -version

两者都应输出有效版本号，且 erl 版本需与当前 Elixir 兼容（例如 Elixir 1.17 要求 OTP 26+）。不匹配会导致 mix test 卡住、Debugger 启动失败但无明确提示。

必须启用 ElixirLS 插件并配置正确的 projectRoot

VS Code 官方市场中唯一被社区广泛验证的 Elixir 插件是 elixir-lsp.elixir-ls。它不是“语法高亮工具”，而是基于 Language Server Protocol 的完整开发后端，提供跳转、补全、格式化和调试支持。

常见问题集中在工作区配置上：

• 打开的是子目录（比如只打开了 lib/），插件找不到 mix.exs，会静默禁用调试功能
• mix.exs 存在但项目未执行过 mix deps.get，插件会反复提示 “Project not compiled”，此时断点全部失效
• 工作区设置了 "elixirLS.projectRoot": "./some-other-dir"，但路径错误或指向非 Mix 项目，调试器根本不会加载

正确做法：用 VS Code 打开包含 mix.exs 的根目录，确保终端中能成功运行 mix compile。

调试配置 launch.json 必须用 mix task 模式

Elixir 没有传统意义上的“单文件运行”，调试入口只能是 mix 任务。VS Code 的 .vscode/launch.json 中不能写 "program": "lib/my_app.ex"，必须指定 task 字段。

典型可用配置：

{   "version": "0.2.0",   "configurations": [     {       "type": "elixir-ls",       "request": "launch",       "name": "Mix Task: run",       "task": "run",       "taskArgs": ["--no-halt"],       "projectDir": "${workspaceFolder}"     },     {       "type": "elixir-ls",       "request": "launch",       "name": "Mix Test: current file",       "task": "test",       "taskArgs": ["${fileBasenameNoExtension}"],       "projectDir": "${workspaceFolder}"     }   ] }

注意点：

• "task": "test" 是调试测试的标准方式，${fileBasenameNoExtension} 会自动提取当前打开的 test/some_test.exs 对应的模块名
• 不要手动填 "taskArgs": ["test/test_helper.exs"] —— 这会触发整个测试套件，且无法定位到当前文件
• 如果项目用了 Phoenix，"task": "phx.server" 可用，但需确认 mix phx.server 在终端中能正常启动，否则调试器卡在 “Starting” 状态

断点失效或跳转不到源码的三个高频原因

即使配置全对，断点仍可能灰掉或运行时不命中。核心原因是 Elixir 编译产物（.beam）与源码路径不一致，或调试器没加载对应模块。

排查顺序如下：

• 检查当前文件是否已被编译：运行 mix compile，观察终端是否输出新编译的模块；若提示 “up to date”，尝试删掉 _build/ 目录重编
• 确认断点所在模块已加载：在调试控制台中执行 :observer.start()，查看 “Applications” 或 “Processes” 标签页里是否有你的应用名；没有说明 mix 任务没真正跑起来
• 检查文件编码和换行符：Windows 上用 CRLF 保存的 .ex 文件，在某些 OTP 版本下会导致解析失败，断点位置偏移；统一用 LF 保存（VS Code 右下角可切换）

最隐蔽的问题是：你加了断点的函数是被 defdelegate 转发的，而断点只能打在实际实现处，委托定义行本身不会停。