macOS C++ 开发环境搭建与实战指南

替换为以下内容：

{
  "version": "2.0.0",
  "tasks": [
    {
      "type": "shell",
      "label": "clang++ build active file",
      "command": "/usr/bin/clang++",
      "args": [
        "-std=c++20",
        "-stdlib=libc++",
        "-g",
        "${file}",
        "-o",
        "${fileDirname}/${fileBasenameNoExtension}"
      ],
      "options": {
        "cwd": "${fileDirname}"
      },
      "group": {
        "kind": "build",
        "isDefault": true
      }
    }
  ]
}

新建 main.cpp：

#include <iostream>

int main() {
    std::cout << "Hello from macOS!\n";
    return 0;
}

✅ 现在按 Cmd+Shift+B 即可编译当前 .cpp 文件！

🔧 推荐方案 B：CLion（付费，专业 IDE）

如果你追求 全功能集成开发环境（类似 Windows 上的 Visual Studio），JetBrains 的 CLion 是 macOS 上最佳选择。

• 官网：CLion
• 学生免费，个人版约 $15/月
• 内置 CMake、调试器、测试框架、远程开发等

优点：开箱即用，无需配置；缺点：收费、较吃内存。

🆓 推荐方案 C：Xcode（Apple 官方 IDE，免费）

虽然主要用于 iOS/macOS App 开发，但也能写 C++。

1. 从 App Store 安装 Xcode
2. 创建新项目 → 'macOS' → 'Command Line Tool'
3. Language 选择 C++

⚠️ 缺点：对纯 C++ 项目支持不如 VS Code/CLion 灵活，CMake 支持弱。

第三步：使用 CMake 构建多文件项目（工业标准）

为什么用 CMake？

• 跨平台（macOS/Windows/Linux 一套配置）
• 管理多文件、依赖、测试
• 被 Google、Microsoft、LLVM 等广泛采用

示例：创建一个带测试的 C++ 项目

项目结构：

my_project/
├── CMakeLists.txt
├── src/
│   └── main.cpp
├── include/
│   └── utils.h
└── tests/
    └── test_utils.cpp

1. 安装 CMake（通过 Homebrew）

brew install cmake

2. 编写代码

include/utils.h：

#pragma once
int add(int a, int b);

src/main.cpp：

#include <iostream>
#include "utils.h"

int main() {
    std::cout << "5 + 3 = " << add(5, 3) << "\n";
    return 0;
}

src/utils.cpp（实现）：

#include "utils.h"

int add(int a, int b) {
    return a + b;
}

3. 编写 CMakeLists.txt

cmake_minimum_required(VERSION 3.20)
project(MyProject LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 包含头文件目录
include_directories(include)

# 主程序
add_executable(app src/main.cpp src/utils.cpp)

# 启用测试
enable_testing()

# 添加 Google Test（如果需要）
find_package(GTest QUIET)
if(GTest_FOUND)
    add_executable(tests tests/test_utils.cpp src/utils.cpp)
    target_link_libraries(tests GTest::gtest GTest::gtest_main)
    add_test(NAME UtilsTest COMMAND tests)
endif()

4. 构建与运行

cd my_project
mkdir build && cd build
cmake ..
make
./app

✅ 输出：

5 + 3 = 8

第四步：调试 C++ 程序（使用 VS Code + lldb）

macOS 默认调试器是 LLDB（不是 GDB）。

在 VS Code 中配置调试

1. 在项目根目录创建 .vscode/launch.json：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Debug C++",
      "type": "cppdbg",
      "request": "launch",
      "program": "${fileDirname}/${fileBasenameNoExtension}",
      "args": [],
      "stopAtEntry": false,
      "cwd": "${fileDirname}",
      "environment": [],
      "externalConsole": false,
      "MIMode": "lldb",
      "preLaunchTask": "clang++ build active file"
    }
  ]
}

2. 在代码中设断点（点击行号左侧）
3. 按 F5 启动调试！

💡 提示：确保已通过 Cmd+Shift+B 编译过程序。

第五步：单元测试（Google Test）

安装 Google Test

brew install googletest

编写测试（tests/test_utils.cpp）

#include <gtest/gtest.h>
#include "utils.h"

TEST(UtilsTest, AddPositiveNumbers) {
    EXPECT_EQ(add(2, 3), 5);
}

TEST(UtilsTest, AddNegativeNumbers) {
    EXPECT_EQ(add(-1, -1), -2);
}

更新 CMakeLists.txt（启用测试）

在之前的基础上，添加：

# 查找并链接 GTest
find_package(GTest REQUIRED)
add_executable(tests tests/test_utils.cpp src/utils.cpp)
target_link_libraries(tests GTest::gtest GTest::gtest_main)
add_test(NAME AllTests COMMAND tests)

运行测试

cd build
cmake .. -Dgtest_force_shared_crt=ON
make ./tests

✅ 输出：

[==========] Running 2 tests from 1 test suite.
[----------] Global test environment set-up.
[----------] 2 tests from UtilsTest
[ RUN      ] UtilsTest.AddPositiveNumbers
[       OK ] UtilsTest.AddPositiveNumbers
[ RUN      ] UtilsTest.AddNegativeNumbers
[       OK ] UtilsTest.AddNegativeNumbers
[----------] 2 tests from UtilsTest (0 ms total)
[==========] 2 tests from 1 test suite ran. (0 ms total)
[ PASSED   ] 2 tests.

第六步：常用快捷操作汇总

常见问题解答（FAQ）

Q1：macOS 上能用 GCC 吗？

可以，但不推荐。Apple 已全面转向 Clang，且 Clang 对 C++20/23 支持更好。

brew install gcc g++-13 -std=c++23 ... # 不如直接用 clang++

Q2：如何支持 C++23？

Clang 15+（macOS Sonoma 自带）已支持大部分 C++23 特性。编译时加 -std=c++23 即可。

Q3：VS Code 无法跳转到定义？

确保已安装 C/C++ 扩展，并在 .vscode/c_cpp_properties.json 中配置：

{
  "configurations": [
    {
      "name": "Mac",
      "includePath": ["${workspaceFolder}/**"],
      "defines": [],
      "macFrameworkPath": ["/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks"],
      "compilerPath": "/usr/bin/clang++",
      "cStandard": "c17",
      "cppStandard": "c++20",
      "intelliSenseMode": "macos-clang-arm64"
    }
  ],
  "version": 4
}

总结：macOS C++ 开发最佳实践

现在，你已经拥有了一个 完全现代化、工业级、跨平台兼容 的 C++ 开发环境！

下一步建议：尝试用 CMake + Google Test 重做你之前的练习项目，学习使用 git 管理代码版本，探索 Conan / vcpkg（C++ 包管理器）。