序 · 开始之前§ 0.2
搭好环境:安装编译器,写出第一个程序
装好编辑器、编译器,学会打开终端,亲手把第一个程序编译并运行起来。顺便看看初学者最常踩的几个坑:忘了 -std=c++20(Apple clang 默认按 C++14 编译)、不开警告(读了没有初始值的变量也一声不吭)、用"文本编辑"保存成了 RTF。
上一章只是看。这一章我们在自己的电脑上,把那个 Hello World 亲手编译、运行一遍。
写 C++ 需要三样东西:
| 东西 | 做什么 | 比喻 |
|---|---|---|
| 编辑器 | 写源代码 | 纸和笔 |
| 编译器 | 把源代码翻译成可执行文件 | 翻译 |
| 终端 | 用打字的方式给电脑下命令:编译、运行 | 对讲机 |
下面的步骤按系统分成了几个标签。选一次你的系统,整页的标签都会跟着切换。
第一步:打开终端
Section titled “第一步:打开终端”终端是一个只有文字的窗口:你打一行命令、按回车,电脑执行它,把结果显示出来。编译和运行程序,我们都在这里做。
按 ⌘ + 空格 打开“聚焦搜索”,输入“终端”(或 Terminal),回车。
先完成下面“第二步”安装 Visual Studio。然后在开始菜单里搜索 Developer PowerShell for VS,打开它。这是一个已经设置好编译器的终端;普通的 PowerShell 找不到编译器。
Ubuntu 等不少发行版按 Ctrl + Alt + T 就能打开终端,或者在应用列表里找“终端”(Terminal)。
先记住四个命令就够了:
| 命令 | 作用 | Windows 的 PowerShell |
|---|---|---|
pwd |
显示“我现在在哪个文件夹” | pwd |
ls |
列出当前文件夹里的文件 | ls 或 dir |
cd 文件夹名 |
进入某个文件夹;cd .. 回到上一层 |
同左 |
mkdir 文件夹名 |
新建一个文件夹 | 同左 |
终端里“当前所在的文件夹”很重要:编译器只会在当前文件夹里找你说的那个文件。
第二步:安装编译器
Section titled “第二步:安装编译器”macOS 的编译器叫 clang,装在苹果的“命令行工具”(Command Line Tools)里。在终端里输入:
xcode-select --install会弹出一个窗口,点“安装”,等它下载完成。装好之后检查一下:
$ 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 比较旧,装不上较新的命令行工具,先考虑升级系统。
Windows 上推荐用微软的 Visual Studio(注意不是 Visual Studio Code,那是另一个软件),它的 Community 版对个人免费。
- 在 Visual Studio 官网下载 Community 版的安装程序并运行
- 安装程序会让你选择“工作负载”,勾选 使用 C++ 的桌面开发,然后安装
- 装好后,从开始菜单打开 Developer PowerShell for VS,输入
cl回车。显示出一段包含版本号的说明,就说明编译器可以用了
Visual Studio 的编译器叫 cl(MSVC),命令的写法和 macOS、Linux 不一样,下文会分别给出。
Linux 上一般用 GCC,编译 C++ 的命令叫 g++。Ubuntu、Debian 上:
sudo apt updatesudo apt install g++Fedora 上:
sudo dnf install gcc-c++装好后用 g++ --version 检查版本。本书用到的 std::format(第 1.9 节)需要 GCC 13 或更新的版本;如果你的版本更低,大部分章节仍然可以学,只是那几个例子编译不过。
第三步:准备编辑器
Section titled “第三步:准备编辑器”源代码就是普通的文本文件,任何“纯文本编辑器”都能写。推荐 Visual Studio Code(简称 VS Code):免费,三个系统都能用,会给代码上色。到官网下载安装即可,本书不需要额外的插件。
第四步:写下第一个程序
Section titled “第四步:写下第一个程序”- 在你的用户文件夹(主目录)里新建一个文件夹
cpp,以后本书的练习都放在这里 - 打开 VS Code,选择“文件 → 打开文件夹”,打开
cpp - 新建一个文件,命名为
hello.cpp,输入下面的代码(最好一个字一个字敲,别复制,熟悉一下),保存
#include <iostream>
int main() { std::cout << "Hello, world!\n"; return 0;}第五步:编译和运行
Section titled “第五步:编译和运行”回到终端,进入 cpp 文件夹,编译,运行:
先输入 cd cpp 进入文件夹,然后:
$ 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!
在 Developer PowerShell 里:
cd ~\cppcl /std:c++20 /EHsc /W4 hello.cpp.\hello.execl 会显示几行版本和处理过程的信息,然后生成 hello.exe。运行后应该看到 Hello, world!。/std:c++20 指定 C++20 标准,/W4 打开较多的警告,/EHsc 是 C++ 标准库需要的一个异常处理设置,照写就好。
cd ~/cppg++ -std=c++20 -Wall -Wextra hello.cpp -o hello./hello和 macOS 的命令一样,只是把 clang++ 换成 g++。没有错误的话编译命令不显示任何东西,运行后看到 Hello, world!。
恭喜,你的第一个 C++ 程序跑起来了。
编译命令的每一部分
Section titled “编译命令的每一部分”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,输出) |
以 - 开头的叫选项,用来调整编译器的行为。其中两个值得多说几句。
为什么一定要写 -std=c++20
Section titled “为什么一定要写 -std=c++20”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:
#include <format>#include <iostream>
int main() { std::cout << std::format("1 + 2 = {}\n", 1 + 2); return 0;}$ 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’)。加上之后一切正常。
为什么一定要打开警告
Section titled “为什么一定要打开警告”下面这个程序有两个问题:apples 定义了却从来没用过;oranges 没有给它一个初始值,就拿来输出了。
#include <iostream>
int main() { int apples = 3; int oranges; std::cout << "I have " << oranges << " oranges\n"; return 0;}不开警告,编译器一声不吭,程序也照常运行,输出一个莫名其妙的数:
$ clang++ -std=c++20 warn.cpp -o warn $ ./warn I have 2 oranges
其中有的输出每次运行可能不同。
打开警告,编译器把两个问题都指了出来,连怎么改都告诉你了(= 0):
$ 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) |
| 改了代码,运行结果没变 | 忘了重新编译 | 每次改完都要重新编译 |
如果暂时装不上
Section titled “如果暂时装不上”可以先用在线编译器,比如 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 编译 - 一定要打开警告:读了没有初始值的变量,不开警告时编译器一声不吭
- 编译时什么都没显示,说明成功了
编译时不写 -o hello,只写 clang++ -std=c++20 hello.cpp,会生成什么文件?怎么运行它?
查看答案
会生成一个叫 a.out 的可执行文件,用 ./a.out 运行:
$ clang++ -std=c++20 hello.cpp $ ls a.out hello.cpp $ ./a.out Hello, world!
a.out 是不指定名字时的默认名字(来自很早以前 Unix 上的“汇编器输出”,assembler output)。名字不影响程序的内容。
编译好之后,运行时只输入了 hello,没有写前面的 ./。会发生什么?./ 是什么意思?
查看答案
$ hello zsh: command not found: hello $ ./hello Hello, world!
终端说找不到 hello 这个命令。你输入一个命令时,终端只会去几个固定的文件夹里找(clang++、ls 都在那些文件夹里),不会在当前文件夹里找。. 表示“当前文件夹”,./hello 的意思是“当前文件夹里的 hello”,这样终端就知道去哪里找了。
如果把文件存成了 hello.txt,然后用 clang++ -std=c++20 -Wall -Wextra hello.txt -o hello 编译,会怎样?
查看答案
$ 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 就好了。
正文里打开警告之后,编译器给出了两条 warning 和一条 note。编译出来的程序还能运行吗?按照编译器的提示,代码应该怎么改,才能一条警告都没有?
查看答案
能运行。警告不会阻止编译,可执行文件照样生成了,只是程序的行为很可能不是你想要的。
两条警告分别是:
unused variable 'apples':定义了apples却没用。删掉int apples = 3;这一行,或者把它也输出出来variable 'oranges' is uninitialized when used here:oranges没有初始值就被使用了。按 note 的提示,把int oranges;改成int oranges = 0;
改完之后重新编译,就什么都不显示了。
有位同学用 macOS 的“文本编辑”写了 hello.cpp,编译时得到了下面的结果。head -3 hello.cpp 显示文件的前三行。问题出在哪里?
$ 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 重新写一遍并保存。如果一定要用“文本编辑”,先在菜单“格式”里选“制作纯文本”。
正文里的 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 协议开源。