清晰易懂的 C++ 开发环境搭建教程

一、安装 C++ 编译器（三大平台全覆盖）

1. Windows 系统

方案一：MinGW-w64（轻量推荐）

1. 下载 MinGW-w64：
   • 访问 MinGW-w64 官网 → 下载 mingw-w64-install.exe。
2. 安装配置：
   • 架构选择：x86_64（64 位系统）
   • 线程模型：posix
   • 异常处理：seh
   • 安装路径：C:\mingw64（路径不要有中文或空格！）
3. 配置环境变量：
   • 右键“此电脑” → 属性 → 高级系统设置 → 环境变量 → 编辑 Path → 添加 C:\mingw64\bin。
4. 验证安装：

   g++ --version
   # 输出示例：g++ (x86_64-win32-seh-rev0, Built by MinGW-W64 project) 8.1.0
   

方案二：Visual Studio（适合大型项目）

1. 下载 Visual Studio Community 版。
2. 安装时勾选 “使用 C++ 的桌面开发”（包含 MSVC 编译器）。
3. 创建新项目 → 选择 “空项目” → 添加 .cpp 文件即可编写 C++ 代码。

---

2. macOS 系统

1. 安装 Xcode 命令行工具：

   xcode-select --install
   

2. 验证安装：

   clang++ --version
   # 输出示例：Apple clang version 14.0.0 (clang-1400.0.29.202)
   

---

3. Linux 系统（Ubuntu/Debian）

1. 安装编译工具链：

   sudo apt update && sudo apt install build-essential
   

2. 验证安装：

   g++ --version
   # 输出示例：g++ (Ubuntu 11.4.0-1ubuntu1~22.04) 11.4.0
   

---

二、配置代码编辑器（以 VS Code 为例）

1. 安装 VS Code

• 官网下载：https://code.visualstudio.com

2. 安装 C++ 扩展

1. 打开 VS Code → 扩展商店 → 搜索 “C/C++” → 安装 Microsoft 官方扩展。
2. 搜索 “Code Runner” → 安装一键运行插件。

3. 配置编译任务（可选）

1. 创建文件 hello.cpp，输入代码：

   #include <iostream>
   using namespace std;int main() {cout << "你好，世界！" << endl;return 0;
   }
   

2. 按 Ctrl+Shift+B → 选择 “配置任务” → 生成 tasks.json，添加以下内容：

   {"version": "2.0.0","tasks": [{"label": "build","type": "shell","command": "g++","args": ["-g", "${file}", "-o", "${fileDirname}/${fileBasenameNoExtension}.exe"]}]
   }
   

---

三、编写并运行第一个 C++ 程序

1. 命令行编译运行

1. 创建文件 hello.cpp，输入上述代码。
2. 编译代码：

   g++ hello.cpp -o hello  # 生成 hello（或 hello.exe）
   

3. 运行程序：

   ./hello    # macOS/Linux
   hello.exe  # Windows
   # 输出：你好，世界！
   

2. 使用 VS Code 一键运行

1. 安装 Code Runner 插件后，点击右上角 ▶️ 按钮直接运行代码。
2. 或按 F5 启动调试（需提前配置 launch.json）。

---

四、新手容易忽略的细节

1. 环境变量未生效

• 现象：g++ 命令提示 “command not found”。
• 解决：
  • Windows：检查 Path 是否包含 C:\mingw64\bin，并重启终端。
  • macOS/Linux：确认已正确安装命令行工具。

2. 代码文件扩展名错误

• 现象：编译器忽略 .txt 或 .c 文件。
• 解决：确保文件扩展名为 .cpp（如 hello.cpp）。

3. 编译参数缺失

• 现象：链接错误（如 undefined reference to main）。
• 解决：检查代码是否包含 main 函数，编译命令是否完整：

  g++ hello.cpp -o hello  # 必须指定输入文件和输出文件名
  

4. 路径含中文或空格

• 现象：编译失败，提示路径无效。
• 解决：将代码文件放在纯英文路径下（如 D:\my_code）。

---

五、总结

通过本教程，你已成功完成以下操作：

1. 安装 C++ 编译器（覆盖 Windows/macOS/Linux 全平台）。
2. 配置开发环境（解决环境变量、扩展安装等关键问题）。
3. 运行首个 C++ 程序（命令行和 IDE 两种方式）。

下一步建议：

• 学习 C++ 基础语法（推荐《C++ Primer》）。
• 尝试编写小项目（如计算器、学生管理系统）。

遇到问题欢迎留言讨论，祝你早日成为 C++ 高手！ 🚀