必须先安装 Erlang 并配置 PATH，再通过 Package Control 安装官方 Erlang 插件，接着手动配置 Build System 实现编译运行，最后排查常见编码、路径和语法高亮问题。
安装 Erlang 插件前先确认 erl 命令是否可用
Sublime Text 本身不支持 Erlang，必须依赖外部工具链。第一步不是装插件，而是确保系统 PATH 中能调用 erl 和 escript —— 否则后续所有编译、运行、语法检查都会失败。
- 在终端执行
erl -version，应输出类似Erlang/OTP 26 [erts-14.2] - 若提示
command not found，需先安装 Erlang（推荐用asdf或官网二进制包，避免通过 apt/yum 安装过旧版本） - Windows 用户注意：安装时勾选「Add Erlang to PATH」，或手动把
C:\Program Files\erl-XX.X\bin加入系统环境变量
用 Package Control 安装 Erlang 插件（非 erlang-sublime）
Sublime 上最稳定、持续维护的 Erlang 支持插件是官方命名的 Erlang（作者是 erlang-editors），不是名字带 “sublime” 或 “syntax” 的其他变体。装错会导致无高亮、无构建系统、甚至快捷键冲突。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入Package Control: Install Package - 等待列表加载后，输入
Erlang，选择并回车安装 - 安装完成后，打开任意
.erl文件，状态栏应显示Erlang（而非Plain Text） - 若仍为纯文本，右键 →
Set Syntax → Erlang → Erlang手动切换一次，之后会自动识别
配置构建系统让 Ctrl+B 能编译并运行模块
默认插件只提供语法高亮和基础命令，不自带构建系统。要实现 Ctrl+B 编译当前文件、Ctrl+Shift+B 运行，需手动添加 Build System。
- 菜单栏 →
Tools → Build System → New Build System… - 替换全部内容为以下配置（适配 Linux/macOS；Windows 需将
shell_cmd中的erlc改为erlc.bat）：
{
"cmd": ["erlc", "$file"],
"file_regex": "^(.+):([0-9]+):([0-9]+):.*$",
"working_dir": "$file_path",
"selector": "source.erlang",
"variants": [
{
"name": "Run",
"cmd": ["escript", "-s", "$file_base_name"]
}
]
}
- 保存为
Erlang.sublime-build（路径自动为Packages/User/） - 再按
Ctrl+Shift+P→Build System → Erlang激活它 - 注意：
Run变体仅适用于含-export([start/0]).且导出start/0的模块；否则改用erl -noshell -s mod fun args -s init stop形式自定义
调试与常见报错处理
即使配置完成，实际开发中仍常遇到两类问题：一是构建失败但无提示，二是语法高亮异常。根本原因往往不在 Sublime 本身。
-
erlc: command not found：Sublime 在 macOS/Linux 下默认不读取 shell 的~/.zshrc或~/.bash_profile，需在Preferences → Settings – User中显式设置PATH：
{
"path": "/usr/local/bin:/opt/homebrew/bin:/usr/lib/erlang/bin"
}
- 编辑
.hrl头文件时无高亮：插件默认只对.erl和.app.src启用，可右键 →Set Syntax → Erlang → Erlang Header - 中文注释乱码或保存后变问号：在
Preferences → Settings中确认"default_encoding": "UTF-8"且文件本身编码为 UTF-8（无 BOM）
真正麻烦的是 OTP 应用结构支持——Sublime 不解析 rebar.config 或 mix.exs，无法跳转到依赖模块定义。这类需求得换 VS Code + erlang-ls，Sublime 只适合单文件脚本或学习阶段快速验证。
