终端与 Homebrew

终端是你和电脑用文字聊天的工具。学会它，你就打开了 AI 世界的大门。

你将学会： 打开终端、输入第一条命令、安装 Mac 上最重要的工具管理器 Homebrew。

预计时间： 15 分钟

需要什么： 一台 Mac 电脑，仅此而已。

一、什么是终端

你平时用 Mac 的方式是：点图标、拖文件、滚鼠标。这叫图形界面。

终端是另一种方式 —— 你打字告诉电脑要做什么，电脑用文字回复你。

打个比方：

• 图形界面 = 去餐厅看菜单，手指点菜
• 终端 = 直接跟厨师说"来一份番茄炒蛋"

两种方式做的是同一件事，但终端更快、更精确，而且很多 AI 工具只能通过终端使用。

不用害怕。终端不会因为你打错字就把电脑搞坏。最多就是它说一句"我不懂你在说什么"（command not found），然后等你重新输入。

二、打开终端

Mac 自带一个叫 Terminal（终端）的程序，不需要额外安装。

方法一：Spotlight 搜索（推荐）

1. 按下键盘上的 Command + 空格键（Command 是键盘左下角带 ⌘ 符号的键）
2. 屏幕中央会弹出一个搜索框
3. 输入 Terminal（不需要输完，打几个字母就会出现）
4. 按回车键打开

方法二：从应用程序找到

1. 打开 Finder（屏幕底部 Dock 栏最左边的笑脸图标）
2. 点击左侧的 应用程序
3. 打开 实用工具 文件夹
4. 双击 Terminal

打开后，你会看到一个白色（或黑色）的窗口，里面有一行文字。这就是终端。

三、终端界面长什么样

打开终端后，你会看到类似这样的内容：

neo@Mac-Studio ~ %

这一行叫做提示符（prompt），它的含义是：

% 后面有一个闪烁的光标，那就是你打字的地方。

记住一个规则： 输入命令后，按回车键执行。

四、输入你的第一条命令

让我们从三条最简单的命令开始。

4.1 让电脑说一句话

在终端中输入下面这行，然后按回车：

echo "Hello World"

你会看到终端回复：

Hello World

echo 的意思是"重复我说的话"。你让电脑说 Hello World，它就说了。恭喜，这是你的第一条命令。

4.2 查看你在哪个文件夹

输入这条命令，按回车：

pwd

终端会回复类似这样的内容：

/Users/neo

pwd 是 Print Working Directory 的缩写，意思是"告诉我现在在哪个文件夹"。/Users/neo 就是你的家目录（你的用户名会不一样）。

4.3 查看文件夹里有什么

输入这条命令，按回车：

ls

终端会列出当前文件夹里的所有文件和子文件夹：

Desktop    Documents  Downloads  Movies  Music  Pictures

ls 是 List 的缩写，意思是"列出这里的东西"。你在 Finder 中能看到的那些文件夹，用 ls 也能看到。

到这里，你已经学会了三条命令：echo（说话）、pwd（我在哪）、ls（这里有什么）。这就是终端的基本操作方式：输入命令，看回复，再输入下一条。

五、安装 Homebrew

什么是 Homebrew

在 Mac 上装软件，你通常去 App Store 搜索，点"获取"，等它下载。

Homebrew 做的是同样的事，只不过是在终端里完成。你输入一行命令，它就帮你下载、安装、配置好一个工具。

为什么要用 Homebrew？因为很多开发者工具和 AI 工具只能通过 Homebrew 安装，App Store 里找不到。后面要装的 Codex CLI 就是其中之一。

你可以把 Homebrew 理解为：Mac 的命令行版应用商店。

开始安装

把下面这条命令完整地复制粘贴到终端里，然后按回车：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

这条命令做了什么：

• curl 从网上下载 Homebrew 的安装脚本
• /bin/bash 运行这个脚本
• 脚本会自动帮你安装 Homebrew 到正确的位置

安装过程中你会遇到的事情：

1. 要求输入密码 —— 输入你的 Mac 开机密码。注意：输入密码时屏幕上不会显示任何字符（不会出现星号或圆点），这是正常的安全设计。盲打完密码后直接按回车。
2. 要求按回车确认 —— 脚本会告诉你它要做什么，按回车继续。
3. 等待下载 —— 根据网速，可能需要 2-10 分钟。看到进度在动就说明没问题。

安装完成后，终端会显示 "Installation successful!"。

但是，还没结束。

安装脚本结束时，会在屏幕上显示一段非常重要的提示，类似这样：

==> Next steps:
- Run these commands in your terminal to add Homebrew to your PATH:

    echo >> /Users/neo/.zprofile
    echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/neo/.zprofile
    eval "$(/opt/homebrew/bin/brew shellenv)"

你需要把它提示的那几行命令复制粘贴到终端里执行。 每一行输入后都按回车。

为什么需要这一步？Homebrew 装好了，但你的终端还不知道去哪里找它。这几行命令的作用是"告诉终端 Homebrew 装在了 /opt/homebrew 这个位置"。如果跳过这一步，后面输入 brew 命令时会报错"command not found"。

提示： 上面的路径 /opt/homebrew 是 Apple Silicon 芯片（M1/M2/M3/M4）Mac 的安装位置。如果你用的是比较老的 Intel Mac，路径会是 /usr/local，安装脚本会自动处理，不用担心。

六、验证安装

配置完路径后，输入以下命令验证 Homebrew 是否安装成功：

brew --version

如果看到类似这样的输出，说明安装成功：

Homebrew 4.5.x

如果看到 command not found，说明上一步的 PATH 配置没有生效。试试关闭终端窗口，重新打开一个新的终端窗口，再输入 brew --version。

七、常用 Homebrew 命令

Homebrew 安装好了，以下是你日常会用到的命令。现在不需要全部记住，用到的时候回来查就行。

安装软件

brew install 软件名

比如安装 git（一个代码版本管理工具）：

brew install git

Homebrew 会自动下载、编译、安装，全程不需要你操心。

安装带图形界面的应用

有些应用有图形界面（比如浏览器、编辑器），用 --cask 参数安装：

brew install --cask 应用名

比如安装 Visual Studio Code 编辑器：

brew install --cask visual-studio-code

更新 Homebrew 自身

brew update

这条命令更新 Homebrew 的软件目录。就像 App Store 刷新可用更新列表一样。建议偶尔运行一次。

升级已安装的软件

brew upgrade

把你通过 Homebrew 安装的所有软件更新到最新版本。

查看已安装的软件

brew list

列出你通过 Homebrew 安装了哪些东西。

卸载软件

brew uninstall 软件名

速查表

八、常见问题

"command not found: brew"

PATH 没有配置好。重新运行安装脚本结束时给你的那几行命令，或者关闭终端重新打开再试。

安装脚本卡在 "Downloading Command Line Tools"

这是在下载 Apple 的开发者工具（Xcode Command Line Tools），体积较大，可能需要 10-20 分钟。耐心等待，不要关闭终端。

输入密码时没有任何反应

这是正常的。终端出于安全考虑，不显示你输入的密码字符。直接打完密码按回车即可。

安装过程中报错

确保你的 Mac 联网了。如果公司或学校网络有限制，试试切换到手机热点再安装。

总结

你在这一页学会了：

• 终端是用文字和电脑交流的工具
• 用 Spotlight（Command + 空格）可以快速打开终端
• echo、pwd、ls 是最基础的三条命令
• Homebrew 是 Mac 的命令行包管理器，后续安装 AI 工具都要靠它
• brew install 安装软件，brew update 更新目录，brew upgrade 升级软件

下一步

终端和 Homebrew 都准备好了，接下来安装你的第一个 AI 工具。

安装 Codex CLI -->