// 常见错误 1: 缺少分号
int x = 10
int y = 20;  // 错误: expected ';' before 'int'

// 修复:
int x = 10;
int y = 20;

// 常见错误 2: 括号不匹配
int main(void) {
    if (x > 0) {
        printf("positive\n");
    // 错误: expected '}' before end of file
}

// 修复: 确保每个 { 都有匹配的 }

// 常见错误 3: 字符串字面量未闭合
printf("Hello, World!);  // 错误: missing terminating '"' character

// 修复:
printf("Hello, World!");

// 错误 1: 函数参数类型不匹配
void process(int *data);
process(42);  // 错误: incompatible integer to pointer conversion

// 修复:
int x = 42;
process(&x);

// 错误 2: 返回类型不匹配
int get_value(void) {
    return "hello";  // 错误: incompatible types when returning type 'char *'
}

// 修复:
const char *get_value(void) {
    return "hello";
}

// 错误 3: 隐式函数声明（C99/C11）
int main(void) {
    undeclared_function();  // 错误: implicit declaration of function
}

// 修复: 添加正确的头文件或函数声明
#include "myheader.h"

# 错误: fatal error: xxx.h: No such file or directory
# 原因: 头文件路径不对或未安装

# 修复 1: 添加头文件路径
gcc -I/path/to/headers -o hello main.c

# 修复 2: 安装缺失的开发包
sudo apt install libssl-dev      # OpenSSL 头文件
sudo apt install libcurl4-openssl-dev  # libcurl 头文件

# 错误: undefined reference to 'function_name'
# 原因 1: 函数未实现
# 原因 2: 未链接包含该函数的库
# 原因 3: 链接顺序错误

# 诊断
gcc -c main.c -o main.o
nm main.o | grep ' U '  # 查看未定义符号

# 修复: 添加正确的库
gcc main.o -lm -o hello        # 链接数学库
gcc main.o -lpthread -o hello  # 链接线程库

# 链接顺序问题
gcc -lmylib main.o -o hello    # 错误: undefined reference to 'my_func'
gcc main.o -lmylib -o hello    # 正确: 目标文件在前

# 或使用链接组
gcc -Wl,--start-group main.o -lmylib -Wl,--end-group -o hello

# 错误: multiple definition of 'global_var'
# 原因: 多个源文件定义了同名全局变量

# 错误代码:
# file1.c: int count = 0;
# file2.c: int count = 0;

# 修复 1: 使用 extern
# file1.c: int count = 0;           // 定义
# file2.c: extern int count;         // 声明

# 修复 2: 使用 static
# file1.c: static int count = 0;    // 仅在 file1.c 中可见
# file2.c: static int count = 0;    // 仅在 file2.c 中可见

# GCC 10+ 默认 -fno-common，更严格检查
# 临时恢复旧行为（不推荐）
gcc -fcommon -o hello main.c

# 错误: /usr/lib/libfoo.so: undefined reference to 'func@LIBFOO_2.0'
# 原因: 编译时链接的库版本与运行时的版本不匹配

# 诊断
ldd ./hello
readelf -d ./hello | grep NEEDED

# 修复: 确保编译和运行时使用相同版本的库

# 错误: cannot find -lmylib
# 原因: 库文件不存在或路径不对

# 诊断
ls /usr/lib/libmylib.*    # 检查是否存在
ls /usr/local/lib/libmylib.*

# 修复: 添加库路径或安装库
gcc -L/path/to/libs -lmylib -o hello main.c
# 或
sudo apt install libmylib-dev

# GCC 5.1 引入了新的 C++ ABI
# 旧 ABI (pre-C++11): std::string 使用 COW
# 新 ABI (C++11+): std::string 使用 SSO

# 错误示例: 混用不同 ABI 的库
# /usr/lib/libold.so 使用旧 ABI
# 新代码使用新 ABI
# 链接时可能出现: undefined reference to 'std::__cxx11::basic_string...'

# 修复: 使用相同 ABI 编译所有代码
g++ -D_GLIBCXX_USE_CXX11_ABI=1 -std=c++17 -o hello main.cpp

# 运行时错误: version `GLIBC_2.34' not found
# 原因: 编译时使用了较新的 glibc，运行环境 glibc 版本较旧

# 诊断
ldd ./hello
# 查看需要的 glibc 版本

# 修复: 在相同或更新的系统上运行，或静态链接
gcc -static -o hello main.c

# 原因: 访问了无效内存地址

# 诊断 1: 使用 GDB
gcc -g -O0 -o hello main.c
gdb ./hello
(gdb) run
# 程序崩溃后
(gdb) bt  # 查看调用栈

# 诊断 2: 使用 ASan
gcc -fsanitize=address -g -o hello main.c
./hello
# ASan 会报告精确的错误位置

# 常见原因:
# 1. 空指针解引用
# 2. 数组越界
# 3. 使用已释放的内存
# 4. 栈溢出（递归过深）

# 原因: 未对齐的内存访问（某些架构）

# 诊断: 使用 -fsanitize=alignment
gcc -fsanitize=alignment -g -o hello main.c
./hello

# 常见原因:
# 在某些 RISC 架构上，指针强制类型转换可能导致未对齐访问

# 原因: 除以零、NaN、溢出等

# 诊断: 使用 UBSan
gcc -fsanitize=undefined -g -o hello main.c
./hello

# 或使用 fenv
#include <fenv.h>
feenableexcept(FE_DIVBYZERO | FE_OVERFLOW | FE_INVALID);

gcc -save-temps -o hello main.c
# 生成: main.i (预处理), main.s (汇编), main.o (目标文件)

# 检查预处理结果
head -50 main.i

# 检查汇编输出
cat main.s

gcc -v -o hello main.c 2>&1
# 输出: 完整的编译命令、搜索路径、链接步骤

gcc -### -o hello main.c 2>&1
# 输出: GCC 内部执行的命令（不实际执行）

# 查看可执行文件的动态依赖
ldd ./hello

# 查看需要的符号
nm -D ./hello | grep ' U '

# 查看共享库提供的符号
nm -D /usr/lib/libm.so.6 | grep ' T '

# 程序启动失败时
strace ./hello

# 特别关注:
# open() 调用 - 文件是否能找到
# mmap() 调用 - 内存映射是否成功
# execve() 调用 - 程序是否能执行

# 查看警告详情
gcc -Wall -Wextra -fdiagnostics-show-option -o hello main.c

# 将特定警告视为错误
gcc -Werror=return-type -o hello main.c

# 禁用特定警告（不推荐，应修复代码）
gcc -Wno-unused-variable -o hello main.c

gcc --version
gcc -dumpversion          # 主版本号
gcc -dumpfullversion      # 完整版本号
gcc -dumpspecs            # 默认规格

// 检查 GCC 版本
#if __GNUC__ >= 13
    // GCC 13+ 特性
#elif __GNUC__ >= 12
    // GCC 12+ 特性
#else
    // 旧版本
#endif

// 检查 C 标准支持
#if __STDC_VERSION__ >= 201710L
    // C17 特性
#endif

// 检查 C++ 标准支持
#if __cplusplus >= 202002L
    // C++20 特性
#endif

# 原因 1: 头文件包含过多
# 诊断: 使用 -H 显示头文件包含层次
gcc -H -o hello main.c 2>&1 | head -20

# 原因 2: 模板实例化过多（C++）
# 诊断: 使用 -ftime-report
gcc -ftime-report -o hello main.cpp

# 原因 3: LTO 链接慢
# 解决: 使用 -flto=auto 自动并行化
gcc -flto=auto -O2 -o hello main.c

# 使用更快的链接器
gcc -fuse-ld=gold -o hello main.c      # gold 链接器
gcc -fuse-ld=lld -o hello main.c       # lld 链接器（需安装）
gcc -fuse-ld=mold -o hello main.c      # mold 链接器（最快）

# 减少链接的库
gcc -Wl,--as-needed -o hello main.c    # 只链接实际使用的库