第 00 站 · 前置准备展开探险地图
装好工具
选你的电脑。装好 Erlang 和 Elixir。Mix 会跟着 Elixir 一起来。
【前置诊断】为什么这台电脑找不到 Erlang、Elixir 或 Mix：工具没装好、版本不兼容，还是 PATH 没有刷新？
三个命令没有一起到位
同学照着旧教程安装后，erl 能运行，elixir 或 mix 却找不到。另一台电脑三个命令都有，OTP 与 Elixir 的版本却不兼容。先诊断工具链，再碰项目代码。
- 新旧终端中
erl -s erlang halt的结果 elixir --version与mix --version的完整输出- 安装目录是否在当前 PATH 中，以及官方兼容表里的版本组合
它要解决什么
后面的代码要靠这些工具运行。若终端找不到命令，问题还没走到代码那里。先把工具放稳，再去起跑线。
你会做到
能找到自己电脑对应的安装步骤
能分别检查 Erlang、Elixir 和 Mix
知道 Mix 随 Elixir 安装，不去另找下载包
遇到命令不存在时，先重开终端并检查 PATH
- 知道自己的电脑使用 macOS、Linux 还是 Windows
- 保持网络连接，并留出下载安装的时间
- 若系统要求管理员密码，先请家长、老师或电脑管理员确认
只走你电脑这一条路
只选与你电脑相同的一栏。不要把三套命令全跑一遍。安装器或包管理器装完后，可以重开终端检查；Ubuntu 官方脚本要先在当前终端检查，再保存两条 PATH。
用 Homebrew 安装
先在终端运行 brew --version。若找不到 brew，先去 Homebrew 官网按说明安装，再回来继续。
- 打开“终端”应用。
- 安装 Elixir；Homebrew 会把 Erlang 作为依赖一起安装。
- 关闭终端，重新打开一个窗口。
- 运行三个版本命令，确认 Mix 也已到位。
# 只在 macOS 终端运行
brew install elixir
# Erlang 会作为依赖安装，Mix 随 Elixir 安装
erl -s erlang halt
elixir --version
mix --versionHomebrew 会处理依赖。若它提示已有版本，先读完提示，不要急着删除旧目录。
Ubuntu 用官方脚本
Linux 有许多发行版。下面是 Elixir 官网当前给 Ubuntu 的配对示例。版本号若与官网不同，以官网新组合为准。
- 打开终端，先确认自己使用 Ubuntu。
- 下载官方脚本，并安装一组彼此兼容的 Erlang 与 Elixir。
- 在当前终端加入两个命令目录，再检查版本。
- Debian 先核对官方仓库版本；Fedora、Arch 等系统按 Elixir 官方页选择对应命令。
# 只在 Ubuntu 终端运行；先和官网核对版本组合
curl -fsSO https://elixir-lang.org/install.sh
sh install.sh elixir@1.20.2 otp@28.4
# 这两行 PATH 先让当前终端找到新工具
installs_dir=$HOME/.elixir-install/installs
export PATH=$installs_dir/otp/28.4/bin:$PATH
export PATH=$installs_dir/elixir/1.20.2-otp-28/bin:$PATH
# Erlang、Elixir 和 Mix 都应能回答
erl -s erlang halt
elixir --version
mix --version两条 export 都只对当前终端生效，确认成功后要把两条都写进自己的 shell 配置。发行版仓库中的 Erlang 与 Elixir 可能比官网慢几个版本。若只想先体验，可以使用仓库提供的版本；若课程或项目要求指定版本，请使用上方官方脚本，或从 Elixir 官方页选择版本管理器。不要把脚本、系统仓库和版本管理器混在同一套安装里。
用两个官方安装程序
先装 Erlang/OTP，再从 Elixir 官方页面选择与这个 OTP 大版本相配的 Elixir 安装程序。
- 在 Erlang 下载页选择 64-bit Windows Installer，下载后运行。
- 打开新 PowerShell，运行
erl -s erlang halt，记下 OTP 大版本。 - 在 Elixir 安装页选择与该 OTP 大版本相配的 Windows Installer。
- 装完后关闭 PowerShell，再打开一个新窗口检查。
# 安装完成后，在新打开的 PowerShell 中运行
erl -s erlang halt
elixir --version
mix --version
# PowerShell 里的 iex 是另一个命令；这样打开 Elixir 的 IEx
iex.bat不要只看版本数字最大。Windows 安装页会列出当前兼容组合。若已使用 Scoop，也可按官方页面分别安装 erlang 和 elixir。
先看做什么，再看怎么写
两个 shell 都能回应，说明运行环境已经醒了。Windows PowerShell 请用 iex.bat 打开 Elixir 的 IEx。
# 安装完成后，在 IEx 中运行
# 请 Elixir 打印一句话
IO.puts("Elixir 可以运行")
# 查看 Elixir 自己的版本
System.version()
# Elixir 也能直接询问底下的 Erlang/OTP
:erlang.system_info(:otp_release)给工具做一次体检
三个系统都做同一件事：查看 Erlang、Elixir 和 Mix，再让 Mix 列出它能做的任务。
- 01
新开一个终端或 PowerShell，避免继续使用安装前的旧 PATH
- 02
运行 Erlang 检查命令，记下 OTP 大版本
- 03
运行
elixir --version和mix --version - 04
运行
mix help，确认能看到一串 Mix 任务
# macOS、Linux 和 Windows PowerShell 都可运行
erl -s erlang halt
elixir --version
mix --version
mix help- Erlang 命令会打印 OTP 大版本
- Elixir 版本信息中也会出现它正在使用的 Erlang/OTP
- Mix 会显示自己的版本，并列出可以运行的任务
先在安装前一直没有关闭的旧终端里检查，再换到新开的终端。若结果不同，问题多半在 PATH 没有重新载入。
这台电脑能找到 Erlang、Elixir 和 Mix，三个工具已经可以开始本地练习。
版本命令不能证明所有第三方依赖都兼容，也不能证明以后每个项目都能直接编译。
这段代码里的关键词
PATH
终端寻找命令时会查看的一串目录。工具已经安装却提示找不到，常常要检查这里。
版本配对
Elixir 需要能够配合的 Erlang/OTP 版本。不要只挑最大的数字，要看官方安装页的兼容说明。
Mix
Elixir 自带的项目工具。安装 Elixir 后就会得到 mix，不需要第三份安装包。
这里用了哪些设计模式
Health Check
用三个版本命令确认每件必需工具都能启动。
Fail Fast
工具缺失或版本配对失败时，在进入项目之前就停下来。
安装 Elixir 后，怎样安装 Mix？
留一张安装体检单
记下操作系统、OTP、Elixir 和 Mix 版本，再写下命令找不到时先做哪两步。
提示 1先迈一步
先把三个版本命令的输出放在一起，不用抄下每一个括号。
提示 2再缩小一点
第一步可以是关闭终端，再打开一个新窗口。
提示 3离答案很近了
第二步检查 PATH 或回到官方安装页，不要随便下载同名工具。
提示 4从终点往回想
先挑一条“过关信号”，为它写一个最小测试。如果电脑看不出结果，就把这句话改成一个真正能观察到的现象。
写明电脑使用 macOS、Linux 还是 Windows
记录 OTP、Elixir 和 Mix 三类版本
能说明 Mix 为什么不用单独安装
遇到权限问题时知道找家长、老师或电脑管理员
记住三句话
- 1
只执行自己操作系统对应的一套步骤。
- 2
先确保有兼容的 Erlang/OTP；安装器、脚本或包管理器可以代办。Mix 会随 Elixir 到来。
- 3
命令找不到时，先重开终端，再检查 PATH 和官方说明。