跳转到内容

序 · 开始之前§ 0.2

搭好环境:安装编译器,写出第一个程序

装好编辑器、编译器,学会打开终端,亲手把第一个程序编译并运行起来。顺便看看初学者最常踩的几个坑:忘了 -std=c++20(Apple clang 默认按 C++14 编译)、不开警告(读了没有初始值的变量也一声不吭)、用"文本编辑"保存成了 RTF。

上一章只是看。这一章我们在自己的电脑上,把那个 Hello World 亲手编译、运行一遍。

写 C++ 需要三样东西:

东西 做什么 比喻
编辑器 写源代码 纸和笔
编译器 把源代码翻译成可执行文件 翻译
终端 用打字的方式给电脑下命令:编译、运行 对讲机

下面的步骤按系统分成了几个标签。选一次你的系统,整页的标签都会跟着切换。

终端是一个只有文字的窗口:你打一行命令、按回车,电脑执行它,把结果显示出来。编译和运行程序,我们都在这里做。

按 ⌘ + 空格 打开“聚焦搜索”,输入“终端”(或 Terminal),回车。

先记住四个命令就够了:

命令 作用 Windows 的 PowerShell
pwd 显示“我现在在哪个文件夹” pwd
ls 列出当前文件夹里的文件 ls 或 dir
cd 文件夹名 进入某个文件夹;cd .. 回到上一层 同左
mkdir 文件夹名 新建一个文件夹 同左

终端里“当前所在的文件夹”很重要:编译器只会在当前文件夹里找你说的那个文件。

macOS 的编译器叫 clang,装在苹果的“命令行工具”(Command Line Tools)里。在终端里输入:

终端窗口
xcode-select --install

会弹出一个窗口,点“安装”,等它下载完成。装好之后检查一下:

终端macOS · zsh
$ clang++ --version
Apple clang version 21.0.0 (clang-2100.4.1.1)
Target: arm64-apple-darwin27.3.0
Thread model: posix
InstalledDir: /Library/Developer/CommandLineTools/usr/bin

能显示出版本号就说明装好了。第一行的版本号可能和这里不同。本书需要支持 C++20 的版本,如果你的 macOS 比较旧,装不上较新的命令行工具,先考虑升级系统。

源代码就是普通的文本文件,任何“纯文本编辑器”都能写。推荐 Visual Studio Code(简称 VS Code):免费,三个系统都能用,会给代码上色。到官网下载安装即可,本书不需要额外的插件。

  1. 在你的用户文件夹(主目录)里新建一个文件夹 cpp,以后本书的练习都放在这里
  2. 打开 VS Code,选择“文件 → 打开文件夹”,打开 cpp
  3. 新建一个文件,命名为 hello.cpp,输入下面的代码(最好一个字一个字敲,别复制,熟悉一下),保存
hello.cpp
#include <iostream>
int main() {
std::cout << "Hello, world!\n";
return 0;
}

回到终端,进入 cpp 文件夹,编译,运行:

先输入 cd cpp 进入文件夹,然后:

终端macOS · zsh
$ pwd
~/cpp
$ ls
hello.cpp
$ clang++ -std=c++20 -Wall -Wextra hello.cpp -o hello
$ ls
hello		hello.cpp
$ ./hello
Hello, world!
  • pwd 确认现在在 ~/cpp(~ 是你的用户文件夹的简写)
  • 编译之前,文件夹里只有 hello.cpp
  • 编译命令什么都没显示:没有消息就是好消息,说明没有错误也没有警告
  • 编译之后多了一个 hello,这就是可执行文件
  • ./hello 运行它,屏幕上出现 Hello, world!

恭喜,你的第一个 C++ 程序跑起来了。

终端窗口
clang++ -std=c++20 -Wall -Wextra hello.cpp -o hello
部分 意思
clang++ 编译器的名字(Linux 上是 g++)
-std=c++20 按 C++20 标准编译
-Wall -Wextra 打开警告:代码能编译,但看起来像写错了的地方,编译器会提醒你
hello.cpp 要编译的源文件
-o hello 生成的可执行文件叫 hello(o 是 output,输出)

以 - 开头的叫选项,用来调整编译器的行为。其中两个值得多说几句。

C++ 每三年发布一版新标准:C++11、14、17、20、23……每一版都会加入新的功能。编译器支持新标准,却不一定默认使用它。实测:本书测试机上的 Apple clang version 21.0.0 (clang-2100.4.1.1),不写 -std 时按 C++14 编译,也就是十几年前的标准。

C++20 才有的功能,不加这个选项就用不了。比如本书第 1.9 节会用到的 std::format:

fmt.cpp
#include <format>
#include <iostream>
int main() {
std::cout << std::format("1 + 2 = {}\n", 1 + 2);
return 0;
}
终端macOS · zsh
$ clang++ fmt.cpp -o fmt
fmt.cpp:5:23: error: no member named 'format' in namespace 'std'
    5 |     std::cout << std::format("1 + 2 = {}\n", 1 + 2);
      |                       ^~~~~~
1 error generated.
$ clang++ -std=c++20 fmt.cpp -o fmt
$ ./fmt
1 + 2 = 3

第一次没写 -std=c++20,编译器说 std 里没有叫 format 的东西(no member named ‘format’ in namespace ‘std’)。加上之后一切正常。

下面这个程序有两个问题:apples 定义了却从来没用过;oranges 没有给它一个初始值,就拿来输出了。

warn.cpp
#include <iostream>
int main() {
int apples = 3;
int oranges;
std::cout << "I have " << oranges << " oranges\n";
return 0;
}

不开警告,编译器一声不吭,程序也照常运行,输出一个莫名其妙的数:

终端macOS · zsh
$ clang++ -std=c++20 warn.cpp -o warn
$ ./warn
I have 2 oranges

其中有的输出每次运行可能不同。

打开警告,编译器把两个问题都指了出来,连怎么改都告诉你了(= 0):

终端macOS · zsh
$ clang++ -std=c++20 -Wall -Wextra warn.cpp -o warn
warn.cpp:4:9: warning: unused variable 'apples' [-Wunused-variable]
    4 |     int apples = 3;
      |         ^~~~~~
warn.cpp:6:31: warning: variable 'oranges' is uninitialized when used here [-Wuninitialized]
    6 |     std::cout << "I have " << oranges << " oranges\n";
      |                               ^~~~~~~
warn.cpp:5:16: note: initialize the variable 'oranges' to silence this warning
    5 |     int oranges;
      |                ^
      |                 = 0
2 warnings generated.

警告和错误不一样:有错误就编译不出可执行文件;有警告仍然能编译出来,能运行。但警告几乎总是意味着代码有问题。本书的所有例子都用 -Wall -Wextra 编译,而且没有警告。oranges 为什么会是一个奇怪的数,第 1.1 节会讲。

现象 原因 解决
command not found: clang++(或 g++) 编译器没装好,或者命令拼错了 回到第二步检查;注意大小写和加号的个数
command not found: hello 运行时少了 ./ 输入 ./hello(见练习 2)
no such file or directory: 'hello.cpp' 终端当前不在 hello.cpp 所在的文件夹 用 pwd 和 ls 看看自己在哪里,再 cd 过去
unknown file type 文件扩展名不对,比如存成了 hello.txt 改成 .cpp(见练习 3)
第一行就报 expected unqualified-id,后面全是怪符号 用文字处理软件保存,文件不是纯文本 换成 VS Code 重新保存(见练习 5)
改了代码,运行结果没变 忘了重新编译 每次改完都要重新编译

可以先用在线编译器,比如 Compiler Explorer(godbolt.org):在浏览器里写代码、编译、运行,什么都不用装。选择语言 C++,在编译器选项里填上 -std=c++20 -Wall -Wextra,打开程序输出的窗格就能看到运行结果。不过长期来看,还是建议在自己的电脑上装好,后面有些章节需要在终端里做实验。

  • 书中的命令按 macOS 的写法给出:clang++ -std=c++20 -Wall -Wextra 文件名.cpp -o 程序名。Linux 把 clang++ 换成 g++;Windows 用 cl /std:c++20 /EHsc /W4 文件名.cpp
  • 运行结果框里,$ 开头的灰色行是输入的命令,其余是程序的输出
  • 每个例子都在测试机上实际编译运行过,输出就是真实的输出
  • 写 C++ 需要编辑器、编译器和终端
  • 编辑器要用纯文本编辑器,不要用 Word 或“文本编辑”的默认格式
  • 编译命令:clang++ -std=c++20 -Wall -Wextra hello.cpp -o hello,运行:./hello
  • 一定要写 -std=c++20:测试机上的编译器默认按 C++14 编译
  • 一定要打开警告:读了没有初始值的变量,不开警告时编译器一声不吭
  • 编译时什么都没显示,说明成功了
练习 1基础

编译时不写 -o hello,只写 clang++ -std=c++20 hello.cpp,会生成什么文件?怎么运行它?

查看答案

会生成一个叫 a.out 的可执行文件,用 ./a.out 运行:

终端macOS · zsh
$ clang++ -std=c++20 hello.cpp
$ ls
a.out		hello.cpp
$ ./a.out
Hello, world!

a.out 是不指定名字时的默认名字(来自很早以前 Unix 上的“汇编器输出”,assembler output)。名字不影响程序的内容。

练习 2基础

编译好之后,运行时只输入了 hello,没有写前面的 ./。会发生什么?./ 是什么意思?

查看答案
终端macOS · zsh
$ hello
zsh: command not found: hello
$ ./hello
Hello, world!

终端说找不到 hello 这个命令。你输入一个命令时,终端只会去几个固定的文件夹里找(clang++、ls 都在那些文件夹里),不会在当前文件夹里找。. 表示“当前文件夹”,./hello 的意思是“当前文件夹里的 hello”,这样终端就知道去哪里找了。

练习 3基础

如果把文件存成了 hello.txt,然后用 clang++ -std=c++20 -Wall -Wextra hello.txt -o hello 编译,会怎样?

查看答案
终端macOS · zsh
$ clang++ -std=c++20 -Wall -Wextra hello.txt -o hello
ld: unknown file type in 'hello.txt'
clang++: error: linker command failed with exit code 1 (use -v to see invocation)

编译器靠扩展名判断文件里是什么。.cpp 是 C++ 源代码;不认识的扩展名,它就当成已经编译好的文件,直接交给链接器(ld),链接器打开一看,不认识这种文件(unknown file type)。把文件改名为 hello.cpp 就好了。

练习 4进阶

正文里打开警告之后,编译器给出了两条 warning 和一条 note。编译出来的程序还能运行吗?按照编译器的提示,代码应该怎么改,才能一条警告都没有?

查看答案

能运行。警告不会阻止编译,可执行文件照样生成了,只是程序的行为很可能不是你想要的。

两条警告分别是:

  • unused variable 'apples':定义了 apples 却没用。删掉 int apples = 3; 这一行,或者把它也输出出来
  • variable 'oranges' is uninitialized when used here:oranges 没有初始值就被使用了。按 note 的提示,把 int oranges; 改成 int oranges = 0;

改完之后重新编译,就什么都不显示了。

练习 5进阶

有位同学用 macOS 的“文本编辑”写了 hello.cpp,编译时得到了下面的结果。head -3 hello.cpp 显示文件的前三行。问题出在哪里?

终端macOS · zsh
$ head -3 hello.cpp
{\rtf1\ansi\ansicpg936\cocoartf2909
\cocoatextscaling0\cocoaplatform0{\fonttbl\f0\fswiss\fcharset0 Helvetica-Light;}
{\colortbl;\red255\green255\blue255;}
$ clang++ -std=c++20 -Wall -Wextra hello.cpp -o hello
hello.cpp:1:1: error: expected unqualified-id
    1 | {\rtf1\ansi\ansicpg936\cocoartf2909
      | ^
1 error generated.
查看答案

“文本编辑”默认把文件存成 RTF(富文本格式),文件开头是一大串格式说明({\rtf1\ansi...、字体 Helvetica-Light、颜色表),真正的代码被夹在中间,还混着格式符号。编译器从第 1 行第 1 列就看不懂了:expected unqualified-id 大意是“这里应该是一个名字,却不是”。

解决:用 VS Code 重新写一遍并保存。如果一定要用“文本编辑”,先在菜单“格式”里选“制作纯文本”。

练习 6挑战

正文里的 warn.cpp,在测试机上不开优化编译,输出 I have 2 oranges。同一台电脑上,加上优化选项 -O2 再编译运行,输出变成了 I have 70830639 oranges。是编译器坏了吗?哪一个才是“对”的?

查看答案

编译器没有坏,两个都不“对”。oranges 从来没有被赋过值,读它的值在 C++ 里属于未定义行为:标准对这种程序会输出什么不做任何规定。不开优化时,它碰巧读到了那块内存里原来剩下的数;开了优化,编译器生成的代码不一样,读到的又是别的数。换一台电脑、换一个编译器,结果还会不同。

未定义行为是 C++ 里最需要警惕的东西之一,第 2.5 节会专门讲。现在只要记住:打开警告,并且每个变量都给它一个初始值。

程序能跑起来了,但写代码难免出错。下一章(0.3)学习读懂编译器的报错:编译错误、链接错误和运行时错误各长什么样,从哪里看起。

图解系列橙皮书 · 图解游戏算法绿皮书 · 图解 C++(本书)蓝皮书 · 图解数据结构与算法(筹备中)

© 2026 XuYi · 原文 https://cpp.xuyi.dev/start/setup/
文章采用 CC BY-NC-SA 4.0 许可,转载请署名并附原文链接;代码以 MIT 协议开源。