# 方式一：系统包（版本可能较旧）
sudo apt update
sudo apt install erlang

# 方式二：Erlang Solutions 官方仓库（推荐）
wget https://binaries2.erlang-solutions.com/ubuntu/pool/contrib/e/esl-erlang/esl-erlang_27.0-1~ubuntu~jammy_amd64.deb
sudo dpkg -i esl-erlang_27.0-1~ubuntu~jammy_amd64.deb

# 验证安装
erl -version
erl -eval 'erlang:display(erlang:system_info(otp_release)), halt().' -noshell

# 安装
brew install erlang

# 安装特定版本（使用 kerl 或 asdf）
brew install kerl

# 验证
erl -version
which erl

# PowerShell 验证
erl -version

# 安装 asdf（如果尚未安装）
git clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.14.0
echo '. "$HOME/.asdf/asdf.sh"' >> ~/.bashrc

# 添加 Erlang 插件
asdf plugin add erlang https://github.com/asdf-vm/asdf-erlang.git

# 查看可用版本
asdf list all erlang

# 安装指定版本
asdf install erlang 27.0
asdf global erlang 27.0

# 验证
erl -version

# 下载 kerl
curl -O https://raw.githubusercontent.com/kerl/kerl/master/kerl
chmod +x kerl
sudo mv kerl /usr/local/bin/

# 列出可用版本
kerl list releases

# 构建并安装
kerl build 27.0 27.0
kerl install 27.0 ~/erlang/27.0

# 激活
. ~/erlang/27.0/activate

# 验证
erl -version

# Ubuntu/Debian
sudo apt install build-essential autoconf libncurses5-dev \
    libssl-dev flex libwxgtk3.0-gtk3-dev libgl1-mesa-dev \
    libglu1-mesa-dev libpng-dev

# CentOS/RHEL
sudo dnf install gcc make autoconf ncurses-devel openssl-devel \
    flex wxGTK3-devel mesa-libGL-devel mesa-libGLU-devel libpng-devel

# 方式一：官方脚本（推荐）
wget https://s3.amazonaws.com/rebar3/rebar3
chmod +x rebar3
sudo mv rebar3 /usr/local/bin/

# 方式二：从源码构建
git clone https://github.com/erlang/rebar3.git
cd rebar3
./bootstrap
sudo cp rebar3 /usr/local/bin/

# 方式三：Homebrew (macOS)
brew install rebar3

# 验证
rebar3 version

# 创建 OTP 应用
rebar3 new app myapp
cd myapp

# 查看项目结构
tree .
# myapp
# ├── README.md
# ├── rebar.config
# ├── src
# │   ├── myapp.app.src
# │   ├── myapp_app.erl
# │   └── myapp_sup.erl
# └── test
#     └── (测试文件)

# 编译
rebar3 compile

# 运行
rebar3 shell

%% rebar.config

{erl_opts, [
    debug_info,           %% 包含调试信息
    warnings_as_errors,   %% 警告视为错误
    {parse_transform, lager_transform}  %% lager 日志转换
]}.

{deps, [
    {cowboy, "2.12.0"},             %% HTTP 服务器
    {jsx, "3.1.0"},                 %% JSON 库
    {gun, "2.1.0"},                 %% HTTP 客户端
    {jiffy, "1.1.1"}                %% JSON (NIF 实现)
]}.

{relx, [
    {release, {myapp, "0.1.0"}, [myapp, sasl]},
    {dev_mode, true},
    {include_erts, false},
    {sys_config, "config/sys.config"},
    {vm_args, "config/vm.args"}
]}.

{profiles, [
    {prod, [
        {relx, [
            {dev_mode, false},
            {include_erts, true}
        ]}
    ]},
    {test, [
        {deps, [
            {meck, "0.9.2"},
            {proper, "1.4.0"}
        ]}
    ]}
]}.

{dialyzer, [
    {warnings, [
        error_handling,
        underspecs,
        unmatched_returns
    ]},
    {plt_extra_apps, [mnesia]}
]}.

// .vscode/settings.json
{
    "erlang.erlangPath": "/usr/local/bin",
    "erlang.rebar3Path": "/usr/local/bin/rebar3",
    "erlang.linting": true,
    "editor.tabSize": 4,
    "editor.insertSpaces": false,
    "files.associations": {
        "*.erl": "erlang",
        "*.hrl": "erlang",
        "*.app.src": "erlang"
    }
}

# 安装 erlang-ls（语言服务器）
git clone https://github.com/erlang-ls/erlang_ls.git
cd erlang_ls
rebar3 compile
rebar3 escriptize
cp _build/default/bin/erlang_ls /usr/local/bin/

# 或者使用 Erlang LS 预编译版本
# 从 GitHub Releases 下载

# erlang_ls.config（放在项目根目录）
apps_dirs:
  - "lib/*"
deps_dirs:
  - "_build/default/lib/*"
  - "_checkouts/*"
include_dirs:
  - "include"
  - "_build/default/lib/*/include"
diagnostics:
  - dialyzer
  - elvis
  - compiler

-- init.lua (Neovim)
require('lspconfig').erlang_ls.setup{
    cmd = { "erlang_ls" },
    filetypes = { "erlang" },
    root_dir = require('lspconfig').util.root_pattern("rebar.config", ".git"),
    settings = {
        erlang_ls = {
            dialyzerEnabled = true,
            elvisEnabled = true
        }
    }
}

;; .emacs 或 init.el
;; Erlang 官方模式（通常随 Erlang 安装）
(setq load-path (cons "/usr/local/lib/erlang/lib/tools-3.5/emacs" load-path))
(require 'erlang-start)

;; 自动加载
(add-to-list 'auto-mode-alist '("\\.erl\\'" . erlang-mode))
(add-to-list 'auto-mode-alist '("\\.hrl\\'" . erlang-mode))

;; 缩进设置
(setq erlang-indent-level 4)

;; Erlang LS 集成
(require 'lsp-mode)
(add-hook 'erlang-mode-hook #'lsp)

%% 启动 Shell
$ erl
Erlang/OTP 27 [erts-14.0] [source] [64-bit] [smp:8:8] [ds:8:8:10] [async-threads:1]

Eshell V14.0  (abort with ^G)
1> 1 + 1.
2
2> "Hello, Erlang!".
"Hello, Erlang!"
3> halt().

%% 查看历史
1> h().

%% 使用历史结果
2> 1 + 1.
2
3> v(2).     %% 引用第 2 行的结果
2

%% 编译并加载模块
4> c(my_module).

%% 查看模块导出函数
5> m(io).

%% 查看进程信息
6> i().

%% 退出
7> q().

%% Shell 中定义函数需要这样写：
1> Double = fun(X) -> X * 2 end.
#Fun<erl_eval.44.123456789>
2> Double(5).
10

%% Shell 中不能直接使用 -module, -export 等属性
%% 这些只能在 .erl 源文件中使用

%% src/myapp.app.src
{application, myapp, [
    {description, "My Erlang Application"},
    {vsn, "0.1.0"},
    {registered, [myapp_server]},
    {mod, {myapp_app, []}},     %% 启动模块
    {applications, [
        kernel,
        stdlib,
        cowboy    %% 依赖
    ]},
    {env, [
        {port, 8080},           %% 配置项
        {pool_size, 10}
    ]},
    {modules, []},              %% rebar3 自动填充
    {licenses, ["Apache-2.0"]},
    {links, []}
]}.

%% config/vm.args
## 节点名称
-name myapp@127.0.0.1

## Cookie（集群认证）
-setcookie myapp_cookie

## 调度器数量（默认等于 CPU 核心数）
## +S 8:8 表示 8 个 CPU 调度器 + 8 个 IO 调度器

## 最大进程数
+P 1048576

## 最大 ETS 表数量
+e 65536

## 异步线程池大小
+A 128

## 垃圾回收参数
+MBas aobf
+MBacul 0

-module(math_utils).
-export([add/2, divide/2]).

%% 类型规范：接受两个 integer，返回 integer
-spec add(integer(), integer()) -> integer().
add(A, B) ->
    A + B.

%% 可能返回错误的情况
-spec divide(number(), number()) -> {ok, float()} | {error, string()}.
divide(_A, 0) ->
    {error, "division by zero"};
divide(A, B) ->
    {ok, A / B}.

# 构建 PLT（持久查找表，首次运行较慢）
rebar3 dialyzer

# 或手动构建 PLT
dialyzer --build_plt --apps erts kernel stdlib crypto

# 分析单个文件
dialyzer my_module.erl

# 分析项目
dialyzer _build/default/lib/myapp/ebin/

%% 在 Shell 中启动
1> observer:start().

%% 或从菜单启动
%% 应用程序 → observer

# .tool-versions（asdf 版本固定文件）
erlang 27.0