VSCode 依赖本地 erl 和 rebar3 实现 Erlang 开发,需确保 PATH 生效、Erlang 完整安装(含 crypto)、正确安装 pguyot.erlang 插件、配置 tasks.json 编译任务,并在调试时统一节点名与 cookie。

VSCode 本身不运行 Erlang,它只提供编辑、调试和任务集成能力;真正编译和执行靠的是你本地装好的 erl 和 rebar3 —— 插件只是把它们“接”进来而已。
确认 erl 和 rebar3 已就位
所有后续配置的前提是终端里能直接调用 erl 和 rebar3。不是“装了就行”,而是 PATH 必须生效:
- 在 VSCode 集成终端中运行
which erl和which rebar3,必须返回具体路径(如/usr/local/bin/erl);如果报 command not found,说明 PATH 没生效,重启 VSCode 也无效,得先修复 shell 环境(比如检查~/.zshrc或~/.bash_profile是否漏写了export PATH) - Windows 用户注意:不要只依赖 CMD 的 PATH,VSCode 默认启动的是 PowerShell 或 Git Bash,需确保对应 shell 中
erl可执行;rebar3.bat文件若放在 Erlangbin/目录下,要确认其内容为@echo off & escript.exe "%~dpn0" %*,且文件扩展名确实是.bat(不是隐藏的.txt) -
rebar3 --version输出应包含版本号,且不能卡住或报escript: exception error: undefined function crypto:start/0—— 这代表 Erlang 安装不完整(缺 crypto 应用),需重装 OTP 或手动启用:erl -eval 'crypto:start(). halt().' -noshell
安装并验证 Erlang 扩展
VSCode 市场里叫 “Erlang” 的扩展不止一个,但稳定、维护活跃、支持调试的只有 pguyot.erlang(作者是 Pascal Guyot)。别选错:
- 在扩展面板搜索
Erlang,认准发布者是pguyot,安装后重启 VSCode - 打开一个
.erl文件,状态栏右下角应显示Erlang语言模式;按Ctrl+Click(或Cmd+Click)能跳转到io:format/2等 BIF 定义处,说明语言服务器已工作 - 如果跳转失败或无语法高亮,先检查 VSCode 设置里是否误启用了其他 Erlang 相关插件(比如旧版
erlang-ls),冲突会导致功能降级
用 tasks.json 自动化 rebar3 编译
VSCode 的“运行”按钮不会自动编译 Erlang 项目,必须显式配置任务。rebar3 是事实标准,不用 erlc 手动编译:
- 在项目根目录(含
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": "silent", "focus": false, "panel": "shared", "showReuseMessage": true, "clear": true }, "problemMatcher": "$erlang" } ] } - 保存后,按
Ctrl+Shift+B即可触发编译;错误会出现在 Problems 面板,且匹配$erlang能定位到具体行号 - 如果项目不在 workspace 根目录(比如 workspace 是
~/projects,而 Erlang 项目在~/projects/myapp),则command需改为cd myapp && rebar3 compile,否则rebar3找不到配置
调试前必须配对 cookie 和节点名
Erlang 调试本质是 attach 到一个正在运行的节点,VSCode 的 launch 配置只是帮你启动这个节点 —— 但 cookie 不一致,节点根本连不上:
- 调试配置中的
"node": "test@127.0.0.1"里的test是节点名,必须与erl -name test@127.0.0.1启动时一致;IP 地址必须是本机可解析的(127.0.0.1安全,localhost在某些系统 DNS 配置下可能失败) - cookie 是 Erlang 节点间通信的密钥,默认读取
~/.erlang.cookie。VSCode 启动的节点和你在终端手动启动的节点必须用同一个 cookie,否则net_adm:ping/1返回pang - 最稳妥做法:在
launch.json中显式指定 cookie:"env": { "ERL_COOKIE": "ABCDEF123456" }并在终端中也用erl -name test@127.0.0.1 -setcookie ABCDEF123456启动,保持完全一致
最容易被忽略的是:Erlang 节点名必须带 @ 和主机名,不能只写 test;而 VSCode 的调试器对 cookie 敏感度极高,哪怕多一个空格都会导致连接失败 —— 建议把 cookie 字符串全用大写字母+数字,避免特殊字符引发解析问题。



















