把一个 .cpp 文件，
编译成能运行的程序。

1. 打开终端，确认编译器

1. 在 Mac 按 Command + 空格，搜索 Terminal / 终端并打开。
2. 看到可输入文字的提示符后，输入下面命令并按回车。网页中的命令写在终端，不写进 C++ 文件；也不用复制提示符 $、% 或包住代码的三反引号。

clang++ --version

能看到 Clang 的版本文字就继续。版本号不需要与教材机器完全一致，但必须支持 C++20。本教程的编译操作已用 Apple Clang 17 在 Mac 上执行。

xcode-select --install

2. 创建目录，把代码保存为 first.cpp

在终端逐行输入，每行回车：

mkdir -p "$HOME/cpp-practice"
cd "$HOME/cpp-practice"
pwd

mkdir -p 创建练习目录（已存在则继续使用）；cd 切换终端的当前目录；pwd 显示当前位置。$HOME 是你的个人主目录。路径有空格时要加引号，例如 cd "$HOME/My Cpp Practice"。进入目录只改变终端位置，不会移动文件。

先运行 ls 检查目录。若已经有 first.cpp 或 first，保留旧练习，先创建并进入一个新的练习目录，例如 cpp-practice-2；后续所有 cd 都使用你实际选择的路径。源码与程序仍统一命名为 first.cpp 和 first。接着打开终端编辑器：

nano first.cpp

把下面这段完整程序输入或粘贴进去。不要覆盖以前练习的内容。

#include <iostream>
int main() {
    int count{2};
    count = count + 1;
    std::cout << count << '\n';
    return 0;
}

1. 按 Control + O（字母 O）保存，再按回车确认文件名。
2. 按 Control + X 退出编辑器，回到终端。这里用的是 Control，不是 Command。
3. 输入 ls；文件列表应包含 first.cpp。只复制代码到剪贴板，还不等于保存了文件。

若用已有的图形编辑器，保存为这个目录里的纯文本 first.cpp。避免 first.cpp.txt、富文本和弯引号。没有 nano 时也可用这种方式。

3. 编译，然后运行

先生成程序

从这个小节直接开始时，先读命令中编译诊断选项的用途，再执行：

clang++ -std=c++20 -Wall -Wextra first.cpp -o first

编译成功通常没有输出，只会回到提示符。输入 ls，现在应能看到源码 first.cpp 和程序 first。出现 error 时先修正，不继续运行目录里可能残留的旧程序。

再启动程序

先预测 2 + 1 会输出什么，再输入：

./first

终端应显示：

3

. 表示当前目录，所以 ./first 明确指出程序的位置。单独输入 first，终端通常只会到 PATH 中找命令；输入 ./first.cpp 也不会编译 C++。

4. 改一行，亲眼看见“重新编译”

1. 再次执行 nano first.cpp，把 int count{2}; 改成 int count{5};，保存并退出。
2. 先直接执行 ./first。它仍应输出 3：你只改了源码，旧程序还在。
3. 再执行下面这行，编译成功后会运行新程序：

clang++ -std=c++20 -Wall -Wextra first.cpp -o first && ./first

这次应输出 6。以后每次改完代码，先保存，再重新编译；网页的“复制代码”按钮只复制文字。

5. 下载的源码怎么运行？

点击下载后，先确认浏览器把文件存到了哪里。若位于 Downloads 目录，可以执行：

cd "$HOME/Downloads"
ls

确认列表里有 copy.cpp。浏览器若存成 copy (1).cpp，在自己的练习副本中改成便于输入的名字，或在命令中给完整文件名加引号。

clang++ -std=c++20 copy.cpp -o copy && ./copy

这里输入名是 copy.cpp，输出名是 copy，所以运行 ./copy。先预测，再对照第01章的复制与状态例子。其他单文件示例使用对应下载文件；多文件程序与厂商 SDK 按所属章节的完整命令运行。

6. 报错先从哪一条看？

需要求助时，提供实际文件名、pwd、编译命令、第一条完整错误和附近几行源码；不要只提供最后一句“编译失败”。