C++ 开发环境配置总结（基于 MSYS2 和 VS Code）

本文档总结了在 Windows 系统下使用 MSYS2（msys64）搭建 C++ 开发环境的经验，重点涵盖了 ucrt64 和 mingw64 编译器的选择与配置，以及 VS Code 的详细配置方法。以下内容适用于初学者和需要切换编译环境的开发者。

---

一、几种编译器的区别及使用建议

1. 编译器环境概述

MSYS2 提供了多个编译器环境，主要包括 ucrt64 和 mingw64，此外还有 clang64 等可选环境。以下是两种主要环境的对比：

1.1 UCRT64

• C 运行时（CRT）：使用微软的 Universal C Runtime（UCRT，ucrtbase.dll），是 Windows 10 引入的新运行时。
• 特点：
  • 支持更现代的 C++ 标准（例如 C++20、C++23）。
  • 更好的 Unicode 支持，处理中文路径更稳定。
  • 与 Windows 系统集成更紧密，调用 Windows API 更可靠。
  • 工具链更新（例如 GCC 14.x），支持最新特性。
• 适用场景：
  • 现代 C++ 开发，特别是在 Windows 10/11 上运行的项目。
  • 需要使用最新 C++ 特性的项目（例如 <format> 库）。
  • 需要频繁调用 Windows API 的项目。
• 局限：
  • 依赖 UCRT，仅适用于 Windows 10 及以上系统（老系统需要额外安装 UCRT）。

1.2 MINGW64

• C 运行时（CRT）：使用传统的 msvcrt.dll（Microsoft Visual C Runtime），这是 Windows XP 时代的运行时。
• 特点：
  • 兼容性强，生成的程序可以在老系统（例如 Windows 7）上运行。
  • 工具链稍旧（例如 GCC 13.x），但对大多数项目足够。
  • 配置简单，社区支持广泛。
• 适用场景：
  • 初学者，优先推荐，因配置更简单。
  • 需要兼容老系统的项目。
• 局限：
  • 对现代 C++ 标准支持不完整（例如 C++20 的一些特性可能缺失）。
  • Unicode 支持较弱，处理中文路径可能出问题。

1.3 CLANG64（补充）

• 编译器：基于 Clang/LLVM，而非 GCC。
• 特点：
  • 错误提示更友好，适合初学者。
  • 支持现代 C++ 特性，与 ucrt64 类似。
• 适用场景：
  • 需要更好的错误提示或调试体验时。
  • 开发需要 Clang 特有功能（例如静态分析）的项目。

---

2. 使用建议

• 初学者：优先选择 ucrt64，因为它更现代，支持最新 C++ 标准，且在 Windows 10/11 上兼容性更好。
• 需要兼容老系统：选择 mingw64，例如需要支持 Windows 7 的项目。
• 需要更好调试体验：可以尝试 clang64，但配置稍复杂。
• 共存与切换：
  • ucrt64 和 mingw64 可以共存于同一台电脑，它们在 MSYS2 中是隔离的（分别位于 C:\msys64\ucrt64 和 C:\msys64\mingw64）。
  • 切换方法：
    1. 环境变量切换：在系统 Path 中只保留一个环境的 bin 目录（例如 C:\msys64\ucrt64\bin）。
    2. 终端切换：使用 MSYS2 提供的终端（ucrt64.exe 或 mingw64.exe）切换环境。
    3. VS Code 配置：在 c_cpp_properties.json 和 tasks.json 中配置多个环境，随时切换。

---

二、VS Code 中的配置方法

以下是基于 MSYS2 的 ucrt64 环境配置 VS Code 的详细步骤，同时支持切换到 mingw64 环境。

1. 安装和环境变量

• 安装 MSYS2：

  • 下载并安装 MSYS2（msys64），路径例如 C:\msys64。

  • 使用 pacman 安装必要的工具：

    pacman -S mingw-w64-ucrt-x86_64-gcc mingw-w64-ucrt-x86_64-gdb
    pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-gdb
    

• 设置环境变量：

  • 将 C:\msys64\ucrt64\bin 添加到系统 Path 中，主用 ucrt64 环境。
  • 避免同时添加 C:\msys64\mingw64\bin，以防冲突。

2. 配置 tasks.json（编译任务）

tasks.json 定义了编译任务，用于生成可执行文件。

示例 tasks.json：

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: g++.exe 生成活动文件 (UCRT64)",
            "command": "C:\\msys64\\ucrt64\\bin\\g++.exe",
            "args": [
                "-fdiagnostics-color=always",
                "-g",
                "${file}",
                "-o",
                "${fileDirname}\\${fileBasenameNoExtension}.exe",
                "-std=c++17"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": ["$gcc"],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "detail": "编译器: C:\\msys64\\ucrt64\\bin\\g++.exe"
        }
    ]
}

关键点

• command：指向 ucrt64 的 g++.exe，可切换为 C:\msys64\mingw64\bin\g++.exe。
• args：
  • -g：生成调试信息。
  • -std=c++17：指定 C++ 标准，可改为 c++20。
  • ${file} 和 ${fileDirname}\\${fileBasenameNoExtension}.exe：指定输入和输出文件。
• 按 Ctrl+Shift+B 运行任务，验证是否能正确编译。

3. 配置 c_cpp_properties.json（代码补全和 IntelliSense）

c_cpp_properties.json 用于配置代码补全和 IntelliSense。

优化后的 c_cpp_properties.json

{
    "configurations": [
        {
            "name": "UCRT64",
            "includePath": [
                "${workspaceFolder}/**",
                "C:/msys64/ucrt64/include"
            ],
            "defines": [],
            "compilerPath": "C:/msys64/ucrt64/bin/g++.exe",
            "cStandard": "c11",
            "cppStandard": "c++17",
            "intelliSenseMode": "gcc-x64"
        },
        {
            "name": "MINGW64",
            "includePath": [
                "${workspaceFolder}/**",
                "C:/msys64/mingw64/include"
            ],
            "defines": [],
            "compilerPath": "C:/msys64/mingw64/bin/g++.exe",
            "cStandard": "c11",
            "cppStandard": "c++17",
            "intelliSenseMode": "gcc-x64"
        }
    ],
    "version": 4
}

关键点：

• includePath：添加标准库路径（C:/msys64/ucrt64/include），确保 IntelliSense 能解析 等。
• compilerPath：指向具体的 g++.exe 文件。
• cppStandard：与 tasks.json 的 -std 参数保持一致。
• 在 VS Code 右下角切换配置（UCRT64 或 MINGW64）。