VSCode调试Erlang失败主因是环境未正确配置：which erl必须返回路径，erlang.erlPath和rebar3Path需填绝对路径并重启VSCode，tasks.json须配置rebar3 compile任务，调试前需确保application:ensure_all_started/1成功。
VSCode 本身不运行 Erlang 代码，它只调用你本地装好的 erl 和 rebar3。所有“点不了调试”“跳转灰色”“编译失败”的问题，90% 都卡在 erl 在 VSCode 内置终端里根本跑不动——不是插件没装对，是环境没接上。
which erl 在 VSCode 终端必须返回路径
这是整个配置的起点，也是最容易被跳过的验证步骤。插件（比如 pguyot.erlang）启动语言服务器前，会先尝试调用 erl；如果失败，它就静默退场，不报错、不提示，只留一堆灰色按钮。
- 按
Ctrl+`打开 VSCode 内置终端，执行：which erl和which rebar3 - 任一命令返回空或
command not found，立刻停手，别配launch.json，也别改插件设置 - 常见原因：
– 从桌面图标启动 VSCode → 它拿的是系统登录时的 PATH，不包含你~/.zshrc里加的 Erlang 路径
– Windows 上erl.exe路径含中文或空格 → BEAM 启动失败，但错误只埋在语言服务器日志里，终端看不到
– 用asdf管理版本 → 忘了运行asdf reshim erlang，which erl找不到软链接目标
erlang.erlPath 和 erlang.rebar3Path 必须填绝对路径
即使 which erl 有输出，erlang-ls 语言服务器默认也不读系统 PATH。它只认你在 VSCode 设置里显式填的两个路径——而且必须是真实可执行文件的绝对路径，不能是软链接、不能是 erl.bat、也不能是目录。
- 打开 VSCode 设置（
Cmd+,），搜索并设置：
–erlang.erlPath→ 填/usr/local/lib/erlang/bin/erl（macOS/Linux）或C:\Program Files\erl-25.3\bin\erl.exe（Windows）
–erlang.rebar3Path→ 填/home/you/.local/bin/rebar3这类真实路径，不是rebar3.bat，也不是符号链接本身 - 改完后必须彻底重启 VSCode，语言服务器不会热重载
- 验证方式：打开任意
.erl文件，右下角状态栏出现erlang-ls: ready才算生效
tasks.json 编译任务必须基于 rebar3
VSCode 的“运行”按钮不会自动编译 Erlang 项目。你得手动配置 tasks.json 把 rebar3 compile 接进来，否则改完代码直接调试，只会遇到未编译模块导致的 undef 错误。
- 确保项目根目录存在
rebar.config - 按
Ctrl+Shift+P→ 输入Tasks: Configure Task→ 选Create tasks.json file from template→Others - 替换生成的
tasks.json内容为：
{
"version": "2.0.0",
"tasks": [
{
"label": "rebar3 compile",
"type": "shell",
"command": "rebar3 compile",
"group": "build",
"presentation": {
"echo": true,
"reveal": "always",
"focus": false,
"panel": "shared",
"showReuseMessage": true,
"clear": false
}
}
]
}
- 保存后，按
Ctrl+Shift+B就能触发编译；也可在命令面板中运行该任务 - 注意：
rebar3必须能访问项目依赖，否则编译会卡在crypto:start/0报错 —— 表明 Erlang 安装缺crypto应用，需重装 OTP
调试前必须手动验证 application:ensure_all_started/1
VSCode 调试器本质是启动一个带参数的 Erlang 节点再 attach，它不负责解决依赖缺失。如果你的 launch.json 里写的是 "startFun": "application:start"，但实际项目里 myapp 依赖 cowboy 而 cowboy 没 start，调试器会直接报 {error,{not_started,cowboy}} 并退出，连断点都设不上。
- 在项目根目录运行
rebar3 shell - 在 shell 里执行
application:ensure_all_started(myapp).，确认返回ok - 检查
rebar.config是否声明了 deps，以及myapp.app.src里的applications列表是否完整 -
startFun必须匹配真实入口：有些项目用myapp:start/0，有些用myapp_app:start/2，函数签名错一个字符就失败
真正容易被忽略的，是 erl 可执行文件本身是否完整——特别是 crypto 应用是否启用。很多调试失败不是配置问题，而是 erl -eval 'crypto:start(). halt().' -noshell 在终端里就报错，说明 OTP 安装不全。这点没法绕过，得重装或手动修复。
