本文聚焦 C++23 标准下程序基本构成与预处理语法的核心内容，主要讲解程序入口（main 函数）、注释、模块等程序基础构成单元，以及 #include、#define、条件编译等预处理指令的语法规则与使用方式，所有示例均为最小可运行代码。

一、程序基本构成

C++ 程序的基础骨架由程序入口、注释和代码语句构成，C++23 对模块语法的完善是该部分的补充内容，以下是核心语法说明。

1.1 程序入口：main 函数

main 函数是 C++ 程序的唯一执行入口，其语法定义有且仅有以下合法形式，是所有 C++ 程序的核心起点。

写法 1：无参数基础形式

这是最常用的 main 函数写法，适用于无需处理外部输入的场景，返回值为 int 类型表示程序的退出状态，返回 0 代表程序正常结束。

#include <iostream>
int main() {
    std::cout << "Hello, C++23!" << std::endl;
    return 0;
}

写法 2：带命令行参数形式

当需要接收外部命令行传入的参数时，使用该写法。其中 argc 表示参数的总个数，argv 是字符串数组，argv[0] 固定为程序自身的名称或路径，后续元素为传入的具体参数。

#include <iostream>
int main(int argc, char* argv[]) {
    std::cout << "参数个数：" << argc << std::endl;
    for (int i = 0; i < argc; ++i) {
        std::cout << "argv[" << i << "] = " << argv[i] << std::endl;
    }
    return 0;
}

char** argv 是 char* argv[] 的等价写法，二者在语法上完全通用，可根据编码习惯选择使用：

#include <iostream>
int main(int argc, char** argv) {
    return 0;
}

核心语法规则：

• main 函数的返回值类型必须为 int，这是 C++ 标准的强制要求，早期部分编译器兼容的 void main() 并非标准写法，不建议使用；
• C++11 起，main 函数末尾的 return 0 可省略，编译器会自动补充该语句；
• 命令行参数的传递由操作系统控制，argv 数组的长度由 argc 决定，且 argv[0] 始终指向程序自身标识。

1.2 注释语法

注释是用于代码说明的语法元素，编译器在预处理阶段会完全忽略注释内容，C++ 仅支持两种注释形式，无其他扩展语法。

单行注释以 // 开头，作用范围至当前行末尾，可单独成行或写在代码行尾部；多行注释以 /* 开头、*/ 结尾，可跨多行使用，但需注意多行注释不支持嵌套，嵌套写法会导致编译错误。

#include <iostream>
int main() {
    std::cout << "注释语法演示" << std::endl;
    return 0;
}

1.3 C++23 模块语法（补充）

模块是 C++20 引入、C++23 完善的特性，核心用于替代传统头文件包含机制，解决头文件重复包含、编译效率低等问题，其基础语法分为模块定义与模块导入两部分。

模块定义：使用 module 关键字声明模块名称，export 关键字标识对外暴露的内容，可将模块声明与导出合并写为 export module：

export module hello;
export void say_hello() {
    std::cout << "Hello from C++23 Module!" << std::endl;
}

模块导入：使用 import 关键字引入已定义的模块，无需再通过 #include 引入头文件，可直接使用模块导出的内容：

import hello;
int main() {
    say_hello();
    return 0;
}

语法说明：

• 模块语法需编译器版本支持（GCC 11+、Clang 15+、MSVC 2022+）；
• C++23 新增 <version> 头文件，可通过该头文件统一查看编译器支持的 C++ 标准版本，__cplusplus 宏会返回对应版本标识（C++23 对应 202302L）：

  #include <version>
  int main() {
      std::cout << __cplusplus << std::endl;
      return 0;
  }
  

二、预处理指令

预处理指令是编译前执行的语法指令，所有指令均以 # 开头，无分号结尾，是 C++ 语法体系中独立于代码逻辑的核心部分，以下覆盖所有常用预处理指令的核心语法。

2.1 头文件包含：#include

#include 用于引入外部头文件，是代码复用的基础语法，仅有两种合法使用形式，区别在于头文件的查找优先级与适用场景。

使用 <> 包裹头文件名时，编译器优先查找系统标准库目录，适用于引入系统头文件；使用 " 包裹头文件名时，编译器优先查找当前项目目录，适用于引入自定义头文件。此外，头文件内部可嵌套包含其他头文件，这是标准库实现的常用方式。

#include <iostream>
#include <string>
#include <version>
#include "my_header.h"

2.2 宏定义：#define / #undef

#define 用于定义宏，本质是文本替换，无类型检查，分为无参宏和带参宏两类；#undef 用于取消已定义的宏，使宏在后续代码中失效。

2.2.1 无参宏

无参宏是简单的文本替换，定义格式为 #define 宏名 替换文本，替换文本可包含字符串、数值等任意内容，取消宏定义需使用 #undef 宏名。

#include <iostream>
#define PI 3.1415926
#define HELLO "Hello, Macro!"

int main() {
    double area = PI * 2.0 * 2.0;
    std::cout << area << std::endl;
    std::cout << HELLO << std::endl;
    
    #undef PI
    return 0;
}

2.2.2 带参宏

带参宏支持接收参数，定义格式为 #define 宏名(参数列表) 替换文本，为避免运算符优先级导致的逻辑错误，替换文本和参数需用括号包裹。

#include <iostream>
#define ADD(a, b) ((a) + (b))
#define MAX(a, b) ((a) > (b) ? (a) : (b))

int main() {
    std::cout << ADD(10, 20) << std::endl;
    std::cout << MAX(5, 3) << std::endl;
    return 0;
}

2.3 条件编译：#ifdef / #ifndef / #endif

条件编译用于控制代码块是否参与编译，核心作用是实现头文件保护、多环境适配等场景，常用指令包括 #ifdef、#ifndef、#if、#elif、#else、#endif。

头文件保护：这是条件编译最核心的用途，通过 #ifndef 检查宏是否未定义，若未定义则定义宏并包含头文件内容，避免头文件被重复包含导致的重定义错误：

#ifndef MY_HEADER_H
#define MY_HEADER_H
void func() {}
#endif

多环境适配：通过 #ifdef 检查宏是否已定义，或 #if 检查表达式结果，可区分调试模式、发布模式，或适配不同 C++ 标准版本：

#include <iostream>
#define DEBUG

int main() {
#ifdef DEBUG
    std::cout << "调试模式" << std::endl;
#else
    std::cout << "发布模式" << std::endl;
#endif

#if __cplusplus >= 202302L
    std::cout << "支持 C++23" << std::endl;
#else
    std::cout << "不支持 C++23" << std::endl;
#endif
    return 0;
}

2.4 其他常用预处理指令

2.4.1 #pragma

#pragma 是编译器相关的指令，用于设置编译选项，不同编译器支持的子指令不同，常用场景包括禁用警告、设置内存对齐、输出编译提示。

#pragma warning(disable: 4996)
#pragma pack(4)
struct Test {
    char a;
    int b;
};
#pragma pack()
#pragma message("编译 main.cpp")

2.4.2 #line

#line 用于修改编译器的行号和文件名记录，主要用于调试场景，修改后编译器报错时会显示指定的行号和文件名：

#line 100 "my_file.cpp"
#include <iostream>
int main() {
    std::cout << "行号修改测试" << std::endl;
    return 0;
}

2.4.3 #error

#error 用于强制触发编译错误，并输出指定的错误信息，常用来检查编译环境是否满足要求：

#if __cplusplus < 202302L
#error "要求编译器支持 C++23 标准"
#endif

全文总结

1. 程序基本构成：讲解了 main 函数的两种合法写法（无参数、带命令行参数）及核心语法规则，C++ 的两种注释形式（单行、多行），以及 C++23 完善的模块语法（定义、导入）和 <version> 头文件的使用。
2. 预处理指令核心内容：介绍了 #include 头文件包含的两种形式及查找规则，#define/#undef 宏定义（无参、带参）的语法，以及 #ifdef/#ifndef 等条件编译指令的核心用途。
3. 其他预处理指令：补充了 #pragma（编译器选项设置）、#line（行号/文件名修改）、#error（强制编译报错）三类预处理指令的语法与使用场景。