VSCode怎么运行Erlang代码_VSCode配置Erlang环境教程-VSCode-PHP中文网

vscode调试erlang失败主因是环境未正确配置：which erl必须返回路径，erlang.erlpath和rebar3path需填绝对路径并重启vscode，tasks.json须配置rebar3 compile任务，调试前需确保application:ensure_all_started/1成功。

vscode怎么运行erlang代码_vscode配置erlang环境教程

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

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

下载

打开 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}} 并退出，连断点都设不上。