C++使用MinGW在Windows上搭建环境流程-C++-PHP中文网

答案：通过MinGW-w64在Windows上搭建C++开发环境，需下载并解压MinGW-w64至无空格路径，将bin目录添加到系统Path环境变量，验证g++、gcc、gdb命令是否可用，最后用简单C++程序测试编译运行；推荐使用x86_64-posix-seh版本，因其对64位系统支持更好且兼容新C++标准；与传统MinGW相比，MinGW-w64支持64位、更新活跃、集成最新GCC版本；常见配置错误包括路径错误、未加至系统变量、未重启终端或存在多版本冲突，可通过where g++和echo %PATH%排查；在VS Code中需安装C/C++扩展，配置tasks.json用于编译，launch.json用于调试，c_cpp_properties.json用于智能感知，确保preLaunchTask关联编译任务，实现高效开发。

c++使用mingw在windows上搭建环境流程

在Windows系统上搭建C++开发环境，通过MinGW-w64是一个非常直接且高效的途径。它本质上就是为Windows提供了一套GNU工具链，包括GCC编译器、GDB调试器等，让你能在Windows上享受类Unix的开发体验，而无需复杂的虚拟机或WSL。整个流程主要涉及下载MinGW-w64、配置系统环境变量，然后通过命令行或集成开发环境（IDE）来编译和运行C++代码。

解决方案

说实话，我个人觉得，在Windows上搞C++开发，如果不想用Visual Studio那么庞大，MinGW-w64真的是个不错的折衷方案。它轻量，而且能让你更好地理解编译和链接的底层逻辑。

首先，你需要从官方渠道获取MinGW-w64。我通常推荐去SourceForge（

https://sourceforge.net/projects/mingw-w64/files/

登录后复制

）下载。这里面有很多版本，别选错了。一般来说，找一个最新的稳定版本，选择

x86_64-posix-seh

登录后复制

或

x86_64-win32-seh

登录后复制

。

posix

登录后复制

通常在多线程方面表现更好，而

win32

登录后复制

可能在某些特定Windows API调用上兼容性更强，但对于日常开发，差异不大。下载那个压缩包（通常是

.7z

登录后复制

格式）。

下载下来后，找个你觉得舒服的地方解压它。我个人习惯把它放在一个路径短、没有空格的目录，比如

C:mingw64

登录后复制

。这样以后在命令行里操作起来也方便，不容易出幺蛾子。解压完成后，你会看到一个

mingw64

登录后复制

文件夹，里面有

bin

登录后复制

、

include

登录后复制

、

lib

登录后复制

等等。

立即学习“C++免费学习笔记（深入）”；

接下来，最关键的一步来了：配置环境变量。这玩意儿搞不好，你就没法在任何地方直接调用

g++

登录后复制

命令。

右键点击“此电脑” -> “属性” -> “高级系统设置”。
在弹出的“系统属性”窗口中，点击“环境变量”按钮。
在“系统变量”区域，找到名为
```
Path
```
登录后复制
的变量，选中它，然后点击“编辑”。
点击“新建”，然后把你MinGW-w64安装目录下的
```
bin
```
登录后复制
文件夹路径添加进去。比如，如果你解压到了
```
C:mingw64
```
登录后复制
，那这里就填
```
C:mingw64in
```
登录后复制
。
一路点击“确定”，保存所有更改。

环境变量配置完，记得要验证一下。打开一个新的命令提示符（

cmd

登录后复制

）或PowerShell窗口（注意，必须是新的，旧的窗口不会加载新的环境变量）。输入以下命令：

g++ --version
gcc --version
gdb --version

登录后复制

如果能看到类似

g++ (MinGW-W64 x86_64-posix-seh-rev0, ...)

登录后复制

的版本信息，恭喜你，环境搭好了！如果提示

'g++' 不是内部或外部命令...

登录后复制

，那多半是环境变量路径写错了或者没生效。

最后，随便写个简单的C++文件测试一下：

// hello.cpp
#include <iostream>

int main() {
    std::cout << "Hello, MinGW-w64 C++!" << std::endl;
    return 0;
}

登录后复制

保存为

hello.cpp

登录后复制

，然后在命令提示符里进入这个文件所在的目录，执行：

g++ hello.cpp -o hello.exe

登录后复制

这会生成一个

hello.exe

登录后复制

可执行文件。再运行它：

./hello.exe

登录后复制

如果看到输出

Hello, MinGW-w64 C++!

登录后复制

，那就大功告成了！

MinGW-w64与传统MinGW有何区别？我该如何选择？

在我看来，选择MinGW-w64几乎是当前Windows上C++开发的默认和最佳选择，尤其是对于新项目。传统MinGW（或者说，最初由TDM-GCC维护的那个分支）虽然曾经很流行，但它主要面向32位系统，并且在64位支持上相对滞后。我记得我第一次接触的时候，找个能用的64位MinGW就挺费劲的。

MinGW-w64，顾名思义，它从一开始就专注于提供对64位Windows系统的完整支持，当然也兼容32位。这意味着你用它编译出来的程序，无论是32位还是64位，都能在现代Windows系统上跑得很好，而且能充分利用64位系统的内存和性能优势。

更重要的是，MinGW-w64的开发活跃度更高，社区支持也更强。这意味着它能更快地集成最新的GCC版本，支持C++最新的标准（比如C++17, C++20, C++23），并且对各种现代库和API的兼容性也更好。比如，你如果想用一些比较新的第三方库，MinGW-w64通常能提供更好的开箱即用体验。

所以，我的建议是，除非你有非常特殊的、必须使用32位MinGW的遗留项目需求，否则，直接选择MinGW-w64，省心省力，面向未来。

配置MinGW环境变量时常犯的错误有哪些？如何排查？

配置环境变量这事儿，看起来简单，但总有些小坑能让人抓狂。我当年就因为这个，反复折腾了好几次。

码上飞

码上飞（CodeFlying）是一款AI自动化开发平台，通过自然语言描述即可自动生成完整应用程序。

138

查看详情

一个最常见的错误就是路径输错或路径不完整。比如，你可能只把

C:mingw64

登录后复制

加进去了，但实际上编译器可执行文件是在

C:mingw64in

登录后复制

里。或者，手滑打错了字母，多了一个斜杠或少了一个。排查方法很简单：打开文件资源管理器，直接复制你MinGW-w64安装目录下

bin

登录后复制

文件夹的完整路径，然后粘贴到环境变量里，确保路径是精确无误的。

另一个常见问题是没有正确添加到系统变量。Windows环境变量分为“用户变量”和“系统变量”。如果你只加到了“用户变量”里，那么只有当前登录的用户才能使用

g++

登录后复制

命令。而如果加到了“系统变量”里，所有用户都能用。更重要的是，有时候一些IDE或者其他工具可能更倾向于读取系统变量。所以，我一般都建议直接加到“系统变量”的

Path

登录后复制

里。

没有重启命令提示符或IDE也是个经典的“坑”。环境变量的更改不会立即影响到已经打开的程序。所以，每次修改完环境变量，你都必须关闭所有旧的命令提示符窗口、PowerShell窗口，以及任何正在运行的IDE（如VS Code、CLion等），然后重新打开它们，让它们加载新的环境变量。

多个GCC/G++版本冲突也时有发生。如果你之前安装过Visual Studio的C++工具链，或者其他版本的MinGW，或者WSL，它们的

g++

登录后复制

命令可能会相互干扰。Windows会按照

Path

登录后复制

变量中路径的顺序来查找可执行文件，找到第一个匹配的就用它。排查这种问题，可以使用

where g++

登录后复制

命令（在命令提示符或PowerShell中）。它会列出所有找到的

g++

登录后复制

可执行文件的路径，这样你就能知道系统到底在用哪个

g++

登录后复制

了。如果发现有冲突，你可能需要调整

Path

登录后复制

中MinGW-w64路径的顺序，把它放到前面，或者干脆移除那些不再需要的旧版本路径。

最后，如果实在搞不定，可以尝试在命令提示符里输入

echo %PATH%

登录后复制

，这会打印出当前系统所有的

Path

登录后复制

环境变量内容，你可以仔细检查一下你添加的路径是否真的在里面，并且格式是否正确（路径之间用分号隔开）。

如何在VS Code中集成MinGW进行C++开发？

用VS Code配MinGW-w64进行C++开发，这几乎是我日常工作中最常用的组合了，轻巧又强大。

首先，确保你已经按照上面的步骤成功安装并配置了MinGW-w64的环境变量。这是基础。

接着，在VS Code里，你需要安装一些扩展。最核心的就是微软官方的C/C++扩展。它提供了智能感知（IntelliSense）、代码导航、格式化以及调试支持。此外，我个人还会装一个C++ TestMate（如果需要单元测试）或者Code Runner（方便快速运行单个文件）。

安装完扩展后，你需要在你的项目文件夹中进行一些配置。VS Code通过

tasks.json

登录后复制

来定义编译任务，通过

launch.json

登录后复制

来定义调试任务。

创建一个新文件夹作为你的项目，比如

my_cpp_project

登录后复制

。在VS Code中打开这个文件夹。然后，你可以通过以下步骤生成

tasks.json

登录后复制

：

在VS Code中，按下
```
Ctrl+Shift+P
```
登录后复制
（或者
```
F1
```
登录后复制
）打开命令面板。
输入
```
Tasks: Configure Default Build Task
```
登录后复制
并选择它。
选择
```
Create tasks.json file from template
```
登录后复制
。
选择
```
Others
```
登录后复制
（运行外部命令）。

这会生成一个

tasks.json

登录后复制

文件在你的项目根目录下的

.vscode

登录后复制

文件夹里。你需要修改它，让它调用

g++

登录后复制

来编译你的C++文件。一个简单的

tasks.json

登录后复制

可能看起来像这样：

// .vscode/tasks.json
{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "build current file", // 任务名称
            "type": "shell",
            "command": "g++", // 调用g++编译器
            "args": [
                "-g", // 生成调试信息
                "${file}", // 当前打开的文件
                "-o", // 输出可执行文件
                "${fileDirname}\\${fileBasenameNoExtension}.exe" // 输出到当前目录，文件名与源文件相同
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "presentation": {
                "reveal": "always"
            },
            "problemMatcher": "$gcc" // 使用gcc的问题匹配器来解析错误和警告
        }
    ]
}

登录后复制

有了这个

tasks.json

登录后复制

，你就可以在VS Code里打开一个

.cpp

登录后复制

文件，然后按

Ctrl+Shift+B

登录后复制

来编译它了。

接下来是调试。调试需要

launch.json

登录后复制

。

切换到“运行和调试”视图（左侧边栏的虫子图标）。
点击“创建 launch.json 文件”。
选择
```
C++ (GDB/LLDB)
```
登录后复制
。

这会生成一个

launch.json

登录后复制

。你需要修改

program

登录后复制

字段，指向你编译生成的可执行文件。

// .vscode/launch.json
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Debug current file",
            "type": "cppdbg",
            "request": "launch",
            "program": "${fileDirname}\\${fileBasenameNoExtension}.exe", // 指向编译好的可执行文件
            "args": [],
            "stopAtEntry": false,
            "cwd": "${fileDirname}",
            "environment": [],
            "externalConsole": true, // 如果想让程序在外部控制台运行，可以设为true
            "MIMode": "gdb",
            "miDebuggerPath": "gdb.exe", // 确保gdb.exe在你的PATH中
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ],
            "preLaunchTask": "build current file" // 调试前先执行编译任务
        }
    ]
}

登录后复制

现在，你可以在代码中设置断点，然后按

F5

登录后复制

开始调试了。

preLaunchTask

登录后复制

字段非常有用，它能确保你在调试前总是编译最新的代码。

最后，为了让VS Code的IntelliSense（智能感知）更好地工作，你可能还需要配置

c_cpp_properties.json

登录后复制

。这个文件通常在你安装C/C++扩展后，第一次打开C++文件时，VS Code会提示你创建。

// .vscode/c_cpp_properties.json
{
    "configurations": [
        {
            "name": "Win32",
            "includePath": [
                "${workspaceFolder}/**",
                "C:\mingw64\include", // MinGW-w64的头文件路径
                "C:\mingw64\x86_64-w64-mingw32\include" // MinGW-w64的特定架构头文件路径
            ],
            "defines": [
                "_DEBUG",
                "UNICODE",
                "_UNICODE"
            ],
            "compilerPath": "C:\mingw64\bin\g++.exe", // g++的完整路径
            "cStandard": "c17",
            "cppStandard": "c++17",
            "intelliSenseMode": "windows-gcc-x64"
        }
    ],
    "version": 4
}

登录后复制

请注意，