头文件重复包含会导致ODR违规引发重定义错误，必须用#pragma once或#ifndef/#define/#endif防护；二者可共存以兼顾兼容性与简洁性，但宏卫士更标准可靠。
合并多个源文件时，#include 不是“合并”，而是文本包含
直接用 #include "file.cpp" 看似能“合并”，但会导致重复定义错误——比如多个 main()、重复的全局变量或函数实现。C++ 编译器按翻译单元处理每个 .cpp 文件，#include 只是把内容原样塞进去，不是链接时的合并。
真正需要的是：把代码组织成一个可编译的单一翻译单元，同时避免 ODR（One Definition Rule）违规。
- 只保留一个
main()函数，其他文件里的main()必须删掉或注释掉 - 头文件（
.h或.hpp）可以#include多次，但实现（.cpp）不能重复出现 - 如果被包含的
.cpp里有全局变量或非内联函数定义，必须改成inline、static或移到头文件中加inline修饰
手动拼接：适合临时调试或提交单文件作业
把多个 .cpp 和 .h 的内容按依赖顺序粘在一起，用注释分隔，是最直接可控的方式。
典型顺序：#include <iostream> → 自定义头文件声明 → 所有 inline 或 static 实现 → 唯一的 main()。
立即学习“C++免费学习笔记（深入）”；
- 先提取所有
.h中的声明（类定义、函数声明、extern变量），放到最前面 - 把各
.cpp中的函数实现逐个粘贴在对应声明之后；若函数在多个文件中同名，必须重命名或删减 - 遇到
#include "xxx.h"全部删掉——内容已手动整合，再包含会重复 - 对非内联的自由函数，加
inline前缀（如inline void foo() { ... }），否则链接时报multiple definition
用脚本自动化拼接（Python 示例）
手动拼太容易漏，尤其文件多、有嵌套 #include 时。一个轻量脚本比 IDE 插件更可靠。
下面 Python 脚本只做线性展开（不处理宏、条件编译），够大多数教学/竞赛场景用：
#!/usr/bin/env python3
import re
import sys
<p>def expand_includes(content, dirname=""):
lines = []
for line in content.splitlines():
m = re.match(r'#\s*include\s+<a href="https://www.php.cn/link/0c52fe90a6eedf614da3c5515a78175e">"<</a>[">]', line)
if m:
inc_file = m.group(1)
inc_path = f"{dirname}/{inc_file}" if dirname else inc_file
try:
with open(inc_path) as f:
lines.append(f"// === BEGIN {inc_file} ===")
lines.extend(expand_includes(f.read(), dirname=inc_path.rsplit('/', 1)[0]))
lines.append(f"// === END {inc_file} ===")
except FileNotFoundError:
lines.append(line) # 保留原行，不崩溃
else:
lines.append(line)
return lines</p><p>if len(sys.argv) < 2:
print("Usage: python merge.py main.cpp")
exit(1)</p><p>with open(sys.argv[1]) as f:
result = expand_includes(f.read())
print("\n".join(result))运行 python merge.py main.cpp > merged.cpp 即可生成单文件。注意它不会自动去重或解决 ODR，仍需人工检查 main() 和全局符号。
真正可靠的“合并”其实是构建系统层面的事
所谓“合并为一个文件”，本质是绕过标准构建流程。生产环境从不这么做——而是靠 make、CMake 或 clang++ *.cpp 一次性编译多个源文件，让链接器统一处理符号。
-
g++ file1.cpp file2.cpp file3.cpp -o prog是标准做法，无需合并源码 - 如果目标是减少构建依赖（比如发给没装编译器的人），应生成静态可执行文件（
-static），而非拼源码 - 某些嵌入式或竞赛平台要求单文件提交，此时拼接是权宜之计，但必须确保所有模板特化、
constexpr函数、constinit变量都满足 ODR
最容易被忽略的点：模板定义必须在头文件里，且所有使用它的翻译单元都能看到完整定义；拼成单文件后，如果模板实现被放在某个 .cpp 片段末尾，而声明在前面，编译会失败——顺序不能错。
