第 30 章 C 语言速查手册（附录）

第 30 章 C 语言速查手册（附录）

这一章不讲新知识，只做一件很实用的事：把前面 29 章里最容易忘、最常查的内容压缩成几张表，放在一起。写代码时把它当成贴在显示器旁边的那张纸——需要的时候扫一眼就行。

💡 使用建议：真正卡住的时候，先翻到对应的表格定位问题，再回到具体章节看详细的原理和例子。死记硬背没有意义，能在 30 秒内查到答案才是这一章的价值。

30.1 迷路了？先看这张导航图

flowchart TD
    START["我想查……"] --> T1["某个语法该怎么写"]
    START --> T2["编译报错看不懂"]
    START --> T3["程序能跑但结果是错的"]
    START --> T4["想确认某个说法到底对不对"]

    T1 --> C1["第 03~06 章：程序结构、数据类型、运算符、流程控制"]
    T1 --> C2["第 07~12 章：函数、数组、指针、字符串、结构体、初始化"]
    T1 --> C3["第 13~18 章：预处理、内存、文件、IO、标准库、位运算"]

    T2 --> C4["本章 30.6 节：报错信息对照表"]
    T2 --> C5["第 02 章：开发环境与常见错误"]
    T2 --> C6["第 21 章：链接期错误（undefined reference 等）"]

    T3 --> C7["第 20 章：调试（GDB / LLDB / Valgrind / Sanitizer）"]
    T3 --> C8["第 09 章指针、第 14 章动态内存：越界与内存问题的重灾区"]

    T4 --> C9["第 29 章：各标准详解（含大量误传澄清）"]
    T4 --> C10["翻 C 标准草案原文 N3096（见 30.8 节）"]

30.2 类型与格式符对照表

这是出错率最高的一张表。记两条铁律：

1. printf 看到的是提升后的类型（float 会变成 double，char/short 会变成 int）；
2. scanf 需要的是指针，而且不会发生那种提升——%f 要的是 float *，不是 double *。

30.2.1 printf / fprintf 的转换字符

30.2.2 长度修饰符

关于 %n：它要求的是指向有符号整数的指针（%hhn 用 signed char *、%n 用 int *、%ln 用 long *……），而且它有被恶意格式串利用的历史，除非确实需要统计输出长度，否则不要用。

最常用的三个组合，背下来就够用：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

#include <stdio.h>
#include <string.h>   /* strlen */
#include <stddef.h>   /* size_t, ptrdiff_t */

int main(void) {
    const char *s = "hello";
    size_t n = strlen(s);
    printf("%zu\n", n);            /* size_t 用 %zu，输出 5 */

    int arr[10];
    int *p1 = &arr[0], *p2 = &arr[7];
    ptrdiff_t d = p2 - p1;
    printf("%td\n", d);            /* ptrdiff_t 用 %td，输出 7 */

    long long big = 1LL << 40;
    printf("%lld\n", big);         /* long long 用 %lld，输出 1099511627776 */

    return 0;
}

30.2.3 scanf 的配对（注意指针类型！）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

#include <stdio.h>

int main(void) {
    char name[20];
    int age;
    double height;

    /* 正确：%19s 限宽，%d 配 &age，%lf 配 &height */
    if (scanf("%19s %d %lf", name, &age, &height) == 3) {
        printf("姓名: %s, 年龄: %d, 身高: %.2f\n", name, age, height);
    }

    return 0;
}

⚠️ 生产代码里通常不用 scanf 读字符串——它遇到空格就停，还容易把缓冲区写爆。用 fgets 读整行，再用 strtol / strtod 转数值，是更稳的组合（详见第 10、16 章）。

30.3 运算符优先级与结合性（完整版）

一共 15 级，级别越小越先算。这张表不用背，但"哪些坑必须知道"要记住：

必须记住的五个坑

1. &、| 的优先级比 == 低：if (x & 0x0F == 0) 等价于 x & (0x0F == 0)，也就是 x & 0。想判断位必须写 if ((x & 0x0F) == 0)。
2. << 的优先级比加减法低：1 << n + 1 是 1 << (n + 1)，不是 (1 << n) + 1。
3. sizeof 只管紧跟其后的那一个操作数：sizeof arr + 1 是 (sizeof arr) + 1，不是 sizeof(arr + 1)；而且它的操作数通常不会被求值——sizeof(x++) 之后 x 根本没动（变长数组的长度表达式是例外）。
4. ?: 和赋值的结合性是从右到左：a = b = c 等价于 a = (b = c)；x ? y : z = 1 会先算赋值（所以真要用请加括号）。
5. && / || 有短路求值：p != NULL && p->x > 0 是安全的，左边的空指针判断挡住了右边。但不要把有副作用的表达式塞进去，比如 i++ < n && arr[i] > 0——两边的求值顺序虽然有保证，逻辑却容易写崩。

📌 还有一个"不是优先级但同样坑人"的知识点：大多数运算符的求值顺序是未指定的。f() + g() 到底先调谁，标准没说；i = i++ + 1 这类写法更是未定义行为。不确定就拆成两行（详见第 05、27 章）。

30.4 头文件速查

🧭 可移植性排序（从好到差）：ISO C 标准头文件 → POSIX 头文件（<unistd.h> <pthread.h> <sys/socket.h>）→ 附录 K 的 _s 函数 → 编译器扩展。跨平台项目尽量往左边靠。

30.5 常用标准库函数一句话索引

30.6 编译 / 链接错误信息对照表

编译器报错一次往往只报第一条是最准确的，后面的常常是连带的"假错误"。永远从第一条开始改。

30.7 术语速查：把概念钉死

C 语言里很多争执都源于术语用法不统一。这一节帮你把最容易被混用的几组概念一次钉死。

30.8 常用的编译命令与验证手段

30.8.1 编译参数速查

📌 小提醒：-std=c23 这个写法是后来才定下名字的——GCC 14 起才接受它，GCC 9~13 里要写 -std=c2x（同一个东西的旧名字）；Clang 也是从 18 版起才认 -std=c23。好在 c2x 现在仍然被接受，写 -std=c2x 能在新旧编译器上都跑通。-std=c17、-std=c11 则在所有主流编译器上都可用。

30.8.2 一套"能跑起来"的最小组合

1
2
3
4
5
6
7

# 日常开发：严格要求 + 调试信息 + 内存检查
clang -std=c23 -Wall -Wextra -Wpedantic -g -O0 \
      -fsanitize=address,undefined -fno-omit-frame-pointer \
      main.c utils.c -o app

# 发布：优化打开，不要 Sanitizer
clang -std=c23 -Wall -Wextra -O2 -DNDEBUG main.c utils.c -o app

⚠️ 注意：优化（-O2）和 Sanitizer、以及和 -g 都可以共存，但调试体验最好的是 -O0 -g。另外 -DNDEBUG 会让 assert 失效，别在还在排查问题的版本上加它。

30.8.3 想确认一个说法对不对？查原始文档

网上（包括 AI 生成的教程）关于 C 语言的错误说法极多。遇到不确定的点，按这个顺序求证：

1. C 标准草案：N3096 是 C23 的草案，官网 open-std.org 上有 PDF，能搜索全文。标准说了算。
2. cppreference 的 C 部分：查函数原型和可用性版本非常方便，注意区分 C 和 C++ 的页面。
3. 编译器实际行为：写一段 10 行的最小程序，把 -Wall -Wextra -Wpedantic 全打开跑一遍。文档会写错，编译器不会撒谎。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20

/* 验证"某个特性在哪个标准里"的标准套路 */
#include <stdio.h>

int main(void) {
#if defined(__STDC_VERSION__)
    printf("__STDC_VERSION__ = %ld\n", (long)__STDC_VERSION__);
#else
    printf("这是 C89（没有 __STDC_VERSION__）\n");
#endif
    printf("编译器: %s\n",
#if defined(__clang__)
           "Clang " __clang_version__
#elif defined(__GNUC__)
           "GCC " __VERSION__
#else
           "未知编译器"
#endif
    );
    return 0;
}

__STDC_VERSION__ 的取值：C99 是 199901L，C11 是 201112L，C17 是 201710L，C23 是 202311L。这个宏是判断"编译器到底认哪个标准"最可靠的办法。

30.9 收尾：一份"交作业前自查清单"

写完一个 C 程序，准备提交或交付之前，过一遍这张清单：

• 编译命令里带了 -Wall -Wextra，并且做到了零警告（警告往往就是 bug 的苗子）
• 每个 malloc / calloc / realloc 都有对应的 free，错误分支上也记得释放
• 每个 fopen 都有对应的 fclose，返回值都检查过
• 所有数组下标都在范围内（特别注意 <= 和 sizeof 的配合）
• 所有字符串都以 \0 结尾，strncpy 之后手动补过 \0
• 用 scanf 读字符串时都带了宽度（%19s 这种）
• printf 的格式符与实参类型完全匹配（尤其 %zu / %lld / %lf）
• 没有依赖"未定义行为"（如 i = i++、越界访问、重叠 memcpy）
• 用 valgrind 或 -fsanitize=address,undefined 跑过一遍，没有报错
• 在 -O2 下也测试过——优化会暴露 UB，-O0 能跑不代表代码是对的

30.10 写在最后

到这里，这套 C 语言教程就结束了。回头看，我们从 1972 年的贝尔实验室一路走到 C23 标准，覆盖了语法、内存、标准库、并发、网络、工程实践和标准细节。

但 C 语言真正的功夫不在记语法，而在于三件事：

1. 清楚每一块内存归谁管——是栈上的、静态区的，还是堆上要自己释放的；
2. 分清哪些行为有保证、哪些是"看编译器心情"——UB、未指定行为、实现定义行为，这三者的区别值得反复体会；
3. 把"能跑"和"正确"分开看——能跑只说明这次运气好。

遇到不确定的问题，回到 30.8.3 节的办法：查标准、查编译器行为、写最小例子验证。不要相信任何没有来源的断言，包括本章——但本章的每一条，你都可以用上面的方法自己验一遍。