VSCode配置Erlang环境 高并发必备VSCode安装Erlang插件

VSCode配置Erlang环境：高并发开发的必备调试指南

想让VSCode的Erlang插件真正跑起来，有个铁律必须记住：erl命令必须在VSCode的内置终端里直接可用。否则，什么代码跳转、智能补全、断点调试，统统都会失灵——这可不是插件本身的问题，而是环境路径压根没接上。

第一步：确认erl和rebar3在VSCode终端里真能跑

很多开发者遇到“跳转定义”按钮灰色、“调试”选项不可点击，第一反应就是重装插件。其实，问题的根源往往更底层：VSCode启动时，根本没有继承到你系统里配置好的PATH环境变量。

怎么验证？打开VSCode的内置终端（快捷键Ctrl+`），直接输入：

which erl
which rebar3

如果终端返回空白或者提示command not found，那就坐实了环境没配通。这时候，别急着去折腾插件设置，优先解决环境继承问题。通常有这么几个路子：

• 从终端里手动启动VSCode：在你常用的系统终端里，先cd到项目目录，然后执行code .命令。这样启动的VSCode会完整继承当前终端会话的PATH。
• 固化系统路径：把erl和rebar3的可执行文件路径，直接添加到你的shell配置文件里（比如~/.zshrc或~/.bashrc），添加完成后，记得完全退出并重启VSCode。
• Windows用户特别注意：erl.exe的安装路径里最好不要包含中文或空格。如果你用的是asdf这类版本管理工具，确保在执行asdf global erlang 后，运行一下asdf reshim erlang。

第二步：erlang-ls扩展不工作？检查erlang.erlPath和erlang.rebar3Path设置

即便终端里which erl已经能正确输出，erlang-ls语言服务器也可能启动失败。原因在于，这个语言服务器默认并不读取系统的PATH，它依赖的是VSCode设置里的显式配置项。

你需要打开VSCode的设置（Cmd+, 或 Ctrl+,），搜索并准确填写以下两项：

• erlang.erlPath：这里需要填入erl可执行文件的绝对路径。例如，macOS/Linux下可能是/usr/local/lib/erlang/bin/erl，Windows下则是C:\Program Files\erl-25.3\bin\erl.exe。
• erlang.rebar3Path：同样，这里要指向rebar3可执行文件的本体，而不是它的批处理脚本（.bat）或软链接。例如：/home/you/.local/bin/rebar3。

修改完这两项之后，必须重启VSCode，语言服务器才会用新的配置重新拉起。验证是否成功的标志很简单：随便打开一个.erl源文件，观察编辑器右下角的状态栏，如果显示erlang-ls: ready，那就说明配置生效了。

第三步：调试Erlang OTP应用前，先确保application:start/1能在shell里手动跑通

VSCode的调试器，其本质是启动一个附带了调试参数的Erlang节点，然后再附着（attach）上去。如果连最基本的application:start(myapp)在独立shell里都跑不起来，报错{error,{not_started,other_dep}}，那调试配置写得再完美也是白搭。

因此，在启动调试之前，强烈建议先手动走通下面这个流程：

• 在项目根目录下，运行rebar3 shell，这会启动一个加载了项目所有依赖路径的交互式Shell。
• 在Shell中，尝试执行application:ensure_all_started(myapp).，确保你的应用及其所有依赖都能正常启动，没有缺失。
• 最后，对照项目launch.json配置文件里的startFun和startArgs字段，检查函数签名是否与实际代码完全一致。有些项目可能使用自定义的启动函数myapp:start/0，而不是标准的application:start/1。

这里有个常见的坑：startArgs是一个字符串形式的Erlang项式，语法必须严格匹配。比如，配置成"[myapp, permanent]"，多一个空格、少一个括号，都可能导致整个Erlang节点启动失败。

第四步：并发调试时，node名和cookie必须和erl -name启动参数完全一致

进行分布式或并发调试，核心在于节点间的安全认证。VSCode调试器会尝试连接一个已经存在的Erlang节点，而这个节点必须使用与配置完全相同的-name和-setcookie参数启动。

举个例子，如果你的launch.json里是这样配置的：

"node": "myapp@127.0.0.1",
"cookie": "abc123"

那么，你在终端里启动目标节点的命令就必须是：

erl -name myapp@127.0.0.1 -setcookie abc123 -pa _build/default/lib/*/ebin

细节决定成败：漏掉-pa参数会导致模块路径找不到；-name里用localhost，而配置里写的是127.0.0.1，在Erlang看来这就是两个不同的节点，连接自然会失败。

还有一个更隐蔽的问题：某些Linux发行版出于安全考虑，可能会默认禁用epmd（Erlang端口映射守护进程）。当你发现调试器始终无法连接到节点时，不妨先检查一下epmd是否在运行：ps aux | grep epmd。如果没运行，可能需要手动启动或调整系统配置。