Erlang环境变量配置的核心是设置ERLANG_HOME和PATH两个变量，并确保安装目录下的bin路径被正确追加，配置后用erl -version验证即可。
很多新手在Windows或Linux上装好Erlang后，一敲erl命令就提示“不是内部或外部命令”，十有八九是环境变量没配对，这事不难，但细节坑不少，这篇就按系统分类，把配置步骤和排查逻辑一次说透。
Windows下erlang环境变量配置步骤与常见误区
Windows用户一般走图形界面,但搞错变量值、忘记重启终端是高频翻车点，先明确一个概念：环境变量分为用户变量和系统变量，系统变量对所有用户生效，需要管理员权限，个人开发机遵循“系统变量只改PATH，新建变量选用户级”的保守原则，避免误伤其他软件。
配置前确认安装目录与版本号
打开安装路径,默认通常为C:\Program Files\erl-25.3.2（版本号会随下载包变化），重点看目录下有没有bin文件夹，里面必须存在erl.exe和erlsrv.exe，如果用的是解压版（绿色版），路径随意放在D:\tools\erlang也行，但要确保路径中不包含中文字符和空格。
逐步操作：新建ERLANG_HOME与修改PATH
- 按
Win + R，输入sysdm.cpl，回车打开系统属性。 - 切换到“高级”选项卡，点击“环境变量”。
- 在“用户变量”区域点击“新建”，变量名填
ERLANG_HOME，变量值填Erlang的根目录，例如C:\Program Files\erl-25.3.2，注意不要多填\bin进去，这步常有人写错。 - 在下方“系统变量”列表中找到
Path，双击编辑，点击“新建”，追加一行%ERLANG_HOME%\bin。 - 连续点“确定”关闭所有窗口。
验证配置与解决erl命令不生效
重新打开一个新终端（cmd或PowerShell），不要用旧窗口，否则读不到新变量，输入erl -version，能看到类似Erlang (SMP,ASYNC_THREADS) (BEAM) emulator version 15.3.2的输出即成功。
如果依然提示“erl不是内部或外部命令”，按以下顺序排查：
- 检查
ERLANG_HOME的值是否指向根目录，误写成...\bin会直接导致失败。 - 打开cmd,输入
echo %ERLANG_HOME%
- 输入
where erl查看系统实际搜索的路径，若没输出，说明PATH写入顺序有问题，将%ERLANG_HOME%\bin这一行挪到列表靠上位置。
Linux环境下erlang环境变量配置的两种写法
Linux用户喜欢改/etc/profile或~/.bashrc，一个管全局，一个管当前用户，日常开发推荐改~/.bashrc，只对自己生效，不易影响系统服务。
通过export命令写入当前用户的shell配置
以bash为例,如果Erlang装在/usr/local/lib/erlang（通过官方源码包编译安装的默认位置），执行：
echo 'export ERLANG_HOME=/usr/local/lib/erlang' >> ~/.bashrc echo 'export PATH=$ERLANG_HOME/bin:$PATH' >> ~/.bashrc source ~/.bashrc
这里有个细节：source命令的作用是重载当前shell的配置文件，如果用了zsh，则需改动~/.zshrc，并将命令中的>>重定向也改成对应文件，行业共识认为，源码编译安装的Erlang最好显式声明ERLANG_HOME，因为某些第三方库（如RabbitMQ）会硬编码读取该变量。
验证与常见报错处理
终端输入erl，进入交互模式后输入halt().退出（注意末尾有个点），若提示erl: command not found，大概率是PATH写错了：
- 确认
export语句中$PATH放在前还是后，写在前面优先调用，写在后面会被系统原有路径覆盖，但一般不会导致“找不到”。 - 输入
echo $ERLANG_HOME，若输出空白，检查是否因为拼写错误或没有source。 - 使用
find / -name erl 2>/dev/null定位可执行文件，确认实际安装位置与配置路径是否一致。
erlang环境变量配置后erl命令不生效的诊断思路
这个问题出现的频率极高,原因集中在三类：路径错位、终端未刷新、多版本冲突，逐一排查比反复重装有效得多。
检查PATH中是否存在重复或过期路径
部分用户电脑里残留了旧版Erlang或通过命令行工具安装过其他运行时,导致PATH中同时存在多个erl.exe，用命令
where erl（Windows）或which -a erl（Linux）列出所有匹配项，观察第一个结果是否为最新安装版本，若有多个结果，删除PATH中指向其他版本的记录。
区分用户变量与系统变量的优先级
Windows下,用户变量和系统变量会叠加，但系统变量的PATH项（含%ERLANG_HOME%\bin）优先于用户变量，如果你在某一次配置中把ERLANG_HOME写在了用户变量，而全局变量又被别的软件占用，可能导致权限冲突，业内专家建议将ERLANG_HOME和PATH修改统一放在用户变量下，避免修改系统级配置带来的风险。
环境变量生效机制与缓存问题
新的环境变量只在创建后的新进程里生效,如果是从IDE（如IntelliJ IDEA）或JetBrains系工具启动的终端，这些工具可能缓存了旧环境，彻底重启IDE或从“任务管理器”重启Windows资源管理器（explorer.exe）再验证，Linux下若SSH连接长期未断开，可用logout后重新登录。
进阶实操：Erlang相关变量与多版本管理
除了ERLANG_HOME和PATH，Erlang还有几个变量在特定场景下值得手动配置，比如ERL_CRASH_DUMP控制崩溃转储文件位置，REBAR_CACHE_DIR指定rebar3的缓存目录，多数开发者不用改，但做服务端部署时，ERL_CRASH_DUMP能帮你把崩溃日志写到指定盘符。
用kerl实现多版本切换并配置变量
版本切换是日常开发中的高频需求。kerl（Erlang版本管理工具）安装后，通过kerl build 25.3.2 25.3.2和kerl install 25.3.2 ~/erlang-25.3.2编译并安装，安装完成后需要激活：
. ~/erlang-25.3.2/activate
这条命令会自动修改当前shell的PATH指向激活的版本,如果想跨会话持久化，将source ~/erlang-25.3.2/activate写入~/.bashrc，此时不需要再手动设置ERLANG_HOME，kerl会把环境变量一起处理掉。
表格对比：Windows与Linux配置要点差异
| 项目 | Windows | Linux/macOS |
|---|---|---|
| 配置文件 | 图形界面（sysdm.cpl） | ~/.bashrc 或 /etc/profile |
| 变量分隔符 | 分号（;） | 冒号（:） |
| 验证命令 |
|
erl 后执行 halt(). |
| 常见坑 | 误将ERLANG_HOME填成含bin的路径 |
忘记source或修改了错误的shell配置文件 |
| 推荐做法 | 用户变量存放变量定义 | 用户级~/.bashrc中export |
Erlang环境变量配置后续：验证运行环境与依赖库
配置仅是第一步,后续还得检查扩展库能否找到，常见场景是安装cowboy或emqx等依赖时，编译报错提示找不到erl或者ODBC库，这时除了PATH，还需确认ERL_LIBS变量是否指向你的依赖目录。
使用rebar3项目时,执行rebar3 compile，如果报错can't find erlang，说明当前shell没有正确加载环境变量，在Makefile或CI脚本中，建议显式写入：
export PATH := $(ERLANG_HOME)/bin:$(PATH)
用erl shell测试网络相关模块
启动erl后，输入inets:start().，接着执行httpc:request("http://www.baidu.com").，能返回{ok, {...}}说明网络模块和SSL库均正常，SSL证书路径异常时，会提示{error, {failed_connect, ...}}，需要设置ERL_SSL_PATH或在启动命令加-ssl参数。
Q&A：erlang环境变量配置常见疑问解答
问：配置Erlang环境变量后，必须重启电脑才能生效吗？
不需要，Windows下重新打开cmd或PowerShell即可，Linux执行source ~/.bashrc，唯一需重启的是IDE或已运行的服务进程，它们持有的旧环境变量不会自动刷新。
问：系统变量和用户变量都写入了ERLANG_HOME，哪个优先？
系统变量优先，Windows先读取系统变量再读取用户变量，系统变量的PATH项会排在用户变量之前，因此如果系统变量中的路径是错误的，即使你在用户变量中写了正确路径，也可能先被错误路径截获，解决办法是检查并修正系统变量的配置。
问：Win10和Win11系统下erlang环境变量配置有区别吗？
配置逻辑完全一致，图形界面位置和变量编辑方式相同，细微差别在Win11的“系统”设置界面层级更多，但通过sysdm.cpl打开的传统对话框没有变化。