sublime text 配置 erlang 环境需严格按三步执行：先确保终端中 erlc -v 和 erl -version 有输出，再安装官方 erlang 插件（github 地址为 https://github.com/erlang-editors/sublime-erlang），最后手动配置构建系统并写死 erlc 绝对路径、设 working_dir 为 $file_path。

Sublime Text 本身不运行 Erlang，所谓“配置环境”就是三件事：让 .erl 文件正确高亮、Ctrl+B 能调用 erlc 编译、终端里能用 erl 加载测试——缺一不可，且顺序不能乱。

确认 erlc 和 erl 已在终端可用

这是所有后续操作的前提。Sublime 的构建系统本质是执行 shell 命令，它不会自己找 Erlang，只认你环境里已有的命令。跳过这步直接配插件或构建系统，90% 的“没反应”“报错找不到命令”都源于此。

• 在终端运行 erlc -v 和 erl -version，必须输出类似 Erlang/OTP 26 的版本信息
• macOS 用 brew install erlang 通常自动进 PATH；Windows 安装时若没勾选 “Add to PATH”，需手动把 C:\Program Files\erl-25.3\bin 加入系统环境变量（注意路径含空格）
• Linux 用户若用 asdf，确保已执行 asdf global erlang ref，并在新终端中验证 which erlc 有返回
• 别在 Sublime 里试——先关掉编辑器，在干净终端里敲两行命令，能过再往下走

只装官方 Erlang 插件，别碰 Erlang Language Support

语法高亮失效、保存删空行、-spec fun/0 解析失败，大概率是你装错了插件。社区里叫 “Erlang” 的插件不止一个，但只有 erlang-editors 维护的那个才持续适配 OTP 24+。

Tome

Tome是一款面向叙事型页面和演示内容创作的 AI storytelling 工具。

下载

• 按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 Package Control: Install Package
• 搜索 Erlang，只选 GitHub 地址为 https://github.com/erlang-editors/sublime-erlang 的那个安装
• 安装后打开任意 .erl 文件，右下角应显示 Erlang；若仍是 Plain Text，右键 → Set Syntax → Erlang → Erlang 手动切换一次，之后会自动识别
• 装错插件（如已停更的 Erlang Language Support）会导致 -include 跳转失效、-record 字段不补全，且无法修复

构建系统必须写死 erlc 路径，不能依赖 PATH

GUI 应用（包括 Sublime）在 macOS/Linux 上往往继承不到 shell 配置的 PATH，Windows 则因空格和反斜杠解析出错。"cmd": ["erlc", "$file"] 看似简洁，实际在多数环境下会静默失败。

• macOS：在终端运行 which erlc，得到类似 /Users/xxx/.asdf/shims/erlc 的路径；新建 Tools → Build System → New Build System…，填入：

  { "cmd": ["/Users/xxx/.asdf/shims/erlc", "$file"], "file_regex": "^(.+):([0-9]+):([0-9]+):.*$", "working_dir": "$file_path", "selector": "source.erlang" }

• Windows：避免用 C:\Program Files\erl 这类带空格路径，改用短路径（如 C:\Progra~1\erl-25.3\bin\erlc.exe）或复制 erlc.exe 到无空格目录（如 D:\erlang\bin\erlc.exe），再在构建配置中写死该路径
• $file_path 必须显式设置，否则 erlc 可能找不到 -include 的 .hrl 或生成 .beam 到错误位置

分布式项目（rebar3）不能靠默认构建系统

纯 erlc 构建只适用于单文件测试。真实 Erlang 分布式系统（比如用 gen_server、supervisor、rpc 的项目）依赖 rebar3 管理依赖、编译多模块、生成 boot 文件。Sublime 默认构建系统不支持项目级操作。

• 不要试图让构建系统直接调用 rebar3 compile 并期望它自动处理依赖路径——rebar3 的工作流和 erlc 不同，需要完整项目结构（rebar.config、src/ 目录等）
• 推荐做法：写一个 Shell/Batch 脚本封装 rebar3 compile && rebar3 eunit，再让 Sublime 调用它；脚本中显式 cd 到项目根目录，避免路径歧义
• 调试分布式行为（如节点通信、net_kernel 启动）必须回到终端：用 erl -name node@127.0.0.1 -setcookie abc 启动节点，再用 observer:start(). 查看进程树——Sublime 插件做不到这点

最容易被忽略的是：Sublime 的构建系统不校验模块名与文件名是否一致，而 Erlang 强制要求二者相同（如 my_mod.erl 内必须是 -module(my_mod).）。编译通过但运行时报 undef，十有八九是这个原因。