【学习记录】如何在 Windows 和 Linux 上编译 C/C++ 开源项目 —— 从识别构建系统到成功编译

🎯 引言

无论是开发桌面应用、服务器端程序还是嵌入式系统，C/C++ 都是许多开发者首选的语言。然而，由于 Windows 和 Linux 系统之间的差异，在不同平台上编译 C/C++ 源码为可执行文件时可能会遇到各种挑战。

更重要的是，当你下载一个开源项目时，第一步不是盲目运行 make 或 cmake，而是要先判断它使用的构建系统类型，然后选择正确的编译方式。

本文将详细介绍如何在这两个操作系统上编译 C/C++ 源码，并提供一些实用的技巧和注意事项，帮助你更高效地参与开源项目。

---

🧩 如何根据开源项目的类型选择合适的编译方式

✅ 第一步：查看项目结构和关键文件

打开项目根目录，观察是否存在以下关键文件之一：

文件名	说明
CMakeLists.txt	使用 CMake 构建系统
Makefile	使用 Unix Makefile 构建系统
.sln / .vcxproj	使用 Visual Studio 构建系统
configure / autogen.sh	使用 Autotools 构建系统
meson.build	使用 Meson 构建系统
build.gradle / pom.xml	Java 项目，与本章无关

✅ 第二步：根据构建系统选择编译方式

🧱 情况一：发现 CMakeLists.txt —— 使用 CMake 编译

这类项目通常跨平台支持较好，适合 Windows、Linux、macOS 等环境。

• 创建并进入构建目录：

  mkdir build && cd build
  

• 运行 CMake 并生成相应构建文件：
  • 在 Linux/WSL/MacOS 上：

    cmake ..
    make
    

  • 在 Windows 上（使用 MinGW）：

    cmake -G "MinGW Makefiles" ..
    mingw32-make
    

  • 或者使用 MSVC：

    cmake -G "Visual Studio 17 2022" ..
    cmake --build . --config Release
    

🧱 情况二：发现 Makefile —— 使用 make 直接编译

适用于 Linux 或 macOS 下的经典项目，有时也包含 Windows 兼容性处理。

make

如果提示需要配置：

./configure
make

🧱 情况三：发现 .sln 或 .vcxproj 文件 —— 使用 Visual Studio 打开

这是典型的 Windows 原生项目，使用 Microsoft 的 MSVC 编译器。

• 打开 .sln 解决方案文件。
• 选择 Debug/Release 配置。
• 点击“生成” → “生成解决方案”。

🧱 情况四：发现 configure 和 autogen.sh —— 使用 Autotools 构建

这类项目多见于历史悠久的 Linux 软件包。

./autogen.sh
./configure
make

🧱 情况五：没有明显的构建文件 —— 查看 README.md 或文档

很多现代项目不会自带构建脚本，而是提供详细的编译说明。

🔁 总结：判断流程图（适合新手）

当你下载一个开源项目后，第一步不是盲目运行 make 或 cmake，而是要先观察项目的构建系统类型。以下是完整的判断流程：

下载开源项目
        ↓
检查项目根目录的关键文件
        ↓
┌───────────────────────┐
│ 是否有 CMakeLists.txt？│
└───────────────────────┘
         ├── 是 → 使用 CMake 构建
         └── 否
               ↓
    ┌────────────────────┐
    │ 是否有 Makefile？   │
    └────────────────────┘
           ├── 是 → 使用 make 构建
           └── 否
                 ↓
    ┌──────────────────────────┐
    │ 是否有 .sln/.vcxproj 文件？│
    └──────────────────────────┘
           ├── 是 → 使用 Visual Studio 打开
           └── 否
                 ↓
     ┌──────────────────────────┐
     │ 是否有 configure 文件？  │
     └──────────────────────────┘
           ├── 是 → 使用 ./configure + make
           └── 否
                 ↓
       查看 README.md 获取构建说明

🧪 示例分析：GitHub 上几个典型开源项目

项目名称	构建系统	推荐编译方式
FFmpeg	自定义 Makefile	./configure && make
OpenCV	CMake	cmake .. && cmake --build .
VLC Media Player	Autotools/Meson	Linux 推荐 meson，Windows 推荐 MSYS2
Notepad++	Visual Studio	使用 VS 打开 .sln 文件
SQLite	Makefile	make（Linux），Windows 推荐 mingw

---

💻 Windows 环境下编译 C/C++ 源码

🔧 工具准备

• MinGW-w64 或 MSYS2：提供 GCC 编译器链。
• Visual Studio：集成开发环境（IDE），自带 MSVC 编译器。
• CMake：用于跨平台项目管理与构建。

🛠️ 使用 MinGW-w64 或 MSYS2 编译

安装 MinGW-w64 或 MSYS2

1. 下载并安装 MinGW-w64 或MSYS2 。
2. 将 bin 目录添加到系统环境变量中（例如 C:\msys64\mingw64\bin）。

使用 GCC/G++ 编译简单项目

对于简单的项目，可以直接使用 GCC/G++ 进行编译，而无需创建单独的构建目录：

g++ -o my_program main.cpp

如果包含多个 .cpp 文件：

g++ -o my_program main.cpp file_reader.cpp elf_reader.cpp

使用 CMake 构建

当你需要处理更复杂的项目时，可以使用 CMake 来管理构建过程。首先，创建并进入构建目录：

mkdir build && cd build

然后运行 CMake 并生成相应构建文件：

cmake -G "MinGW Makefiles" ..
mingw32-make

🛠️ 使用 Visual Studio 编译

图形界面操作

1. 打开 Visual Studio，创建新项目或打开现有项目。
2. 添加所有 .cpp 文件到项目中。
3. 设置编译选项（如标准版本、优化级别等）。
4. 根据需要选择 Debug 或 Release 配置。
5. 点击“生成”菜单中的“生成解决方案”。

命令行使用 CMake 构建

如果你希望通过命令行使用 CMake 和 Visual Studio 编译器进行构建，可以执行以下命令：

cmake -G "Visual Studio 17 2022" ..
cmake --build . --config Release

🚧 常见问题及解决方法

unistd.h 头文件找不到

fatal error C1083: 无法打开包括文件: “unistd.h”: No such file or directory

✅ 解决方案：使用条件编译适配不同平台：

#ifdef _WIN32
    // Windows-specific code here
#else
    #include <unistd.h>
#endif

-std=c++11 被忽略

cl : 命令行 warning D9002: 忽略未知选项“-std=c++11”

✅ 解决方案：在 CMakeLists.txt 中设置标准版本：

set(CMAKE_CXX_STANDARD 11)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

---

🐧 Linux 环境下编译 C/C++ 源码

🔧 工具准备

• GCC/G++：Linux 默认提供的 C/C++ 编译器。
• CMake：通过包管理器安装最新版 CMake（例如在 Ubuntu 上运行 sudo apt install cmake）。

🛠️ 使用 GCC/G++ 编译

对于简单的项目，可以直接使用 GCC/G++ 进行编译，而无需创建单独的构建目录：

g++ -o my_program main.cpp

如果包含多个 .cpp 文件：

g++ -o my_program main.cpp file_reader.cpp elf_reader.cpp

🛠️ 使用 CMake 编译

创建并进入构建目录

mkdir build && cd build

生成 Makefile 并编译

cmake ..
make

🚧 常见问题及解决方法

编译器找不到

如果提示找不到 C/C++ 编译器，可能是由于环境变量未正确设置或 CMake 缓存问题。清理缓存后重试：

rm -rf *
cmake ..
make

编译选项不兼容

确保 CMakeLists.txt 中设置了合适的最低版本要求：

cmake_minimum_required(VERSION 3.10)
project(YourProjectName)

set(CMAKE_CXX_STANDARD 11)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

---

🌈 跨平台开发技巧

✅ 使用条件编译

#ifdef _WIN32
    // Windows-specific code
#else
    // Unix/Linux-specific code
#endif

✅ 设置 CMake 参数

if(WIN32)
    add_definitions(-DWINDOWS_PLATFORM)
elseif(UNIX)
    add_definitions(-DLINUX_PLATFORM)
endif()

✅ 自动检测系统类型

message("Operating system: ${CMAKE_SYSTEM_NAME}")

---

✅ 结语

无论是在 Windows 还是 Linux 环境下，编译 C/C++ 源码为可执行文件的过程都涉及选择合适的编译器和工具链，并且需要注意不同平台间的差异。

更重要的是，面对开源项目时，理解其构建系统类型 是成功编译的第一步。学会根据项目特点选择合适的编译方式，不仅能提高效率，也能减少很多不必要的错误。

希望这篇指南能帮助你更好地理解如何在不同操作系统上编译 C/C++ 源码，并掌握识别和构建开源项目的方法。如果你有任何疑问或需要进一步的信息，请大家讨论交流！