首先安装 erlang/OTP 并验证版本,然后安装 erlang-ls;在vscode 中安装 Erlang 和 Erlang LS 插件,配置 executablePath 指向 erl 路径,创建标准项目结构及 rebar.config,设置 launch.json 实现节点调试,启用格式化与保存,确保语言服务器正常通信。

要在 VSCode 中配置 Erlang 开发环境,关键在于安装合适的插件、配置编译与调试工具,并确保 Erlang 运行时已正确设置。只要系统中已安装 Erlang/OTP,配合 VSCode 的扩展功能,就能获得良好的 编码 体验。
安装 Erlang/OTP 和 Erlang Language Server
在配置编辑器前,先确保系统中已安装 Erlang/OTP:
- windows用户可从 Erlang 官网 下载预编译安装包
- macos推荐使用 Homebrew:brew install erlang
- linux(ubuntu/debian)可用 apt:sudo apt install erlang
安装完成后,在终端运行 erl -version 验证是否成功。接下来建议安装 erlang-ls(Erlang Language Server),它为编辑器提供智能提示、跳转定义等功能。可通过gitHub 克隆并按说明构建,或使用打包工具如asdf 管理版本。
安装 VSCode 插件
打开 VSCode,进入扩展市场搜索并安装以下插件:
- Erlang(由 p gourlain 提供):基础语法高亮与文件关联
- Erlang LS:官方语言服务器支持,提供补全、诊断、文档悬浮等功能
安装后,VSCode 会自动检测 erl 命令路径。若未识别,请在设置中手动指定 Erlang 可执行文件路径,例如:
“erlang.lsp.executablePath”: “/usr/local/bin/erl”
项目结构与调试配置
一个标准 Erlang 项目通常包含 src/(源码)、ebin/(编译输出)等目录。在根目录创建rebar.config 有助于构建管理(即使不使用 rebar 也建议支持)。
启用调试功能需配置.vscode/launch.json。示例如下:
{"version": "0.2.0", "configurations": [ { "name": "Erlang Attach", "type": "erlang", "request": "attach", "port": 4369, "node": "my_node@127.0.0.1" } ] }
注意:Erlang 调试依赖于 分布式 节点机制,需启动带名字的 Erlang 节点并运行代码,再通过 VSCode 连接。
实用技巧与常见问题
提升开发效率的小建议:
- 开启自动保存和格式化:在设置中启用format on Save
- 使用 emacs 键绑定?Erlang 社区传统上偏好 Emacs,但 VSCode 也支持部分快捷键模拟
- 若语言服务器无响应,检查 erlang_ls.config 是否存在且路径正确
- 确保 防火墙 未阻止 Erlang 节点通信 端口
基本上就这些。配置一次后,后续项目可复用大部分设置。虽然 Erlang 生态工具链不如主流语言丰富,但在 VSCode 中已足够支撑日常开发。


