Trae 配置 C++ 编译环境实战指南

• C/C++ Debug (KylinIdeTeam) - 用于 GDB 调试支持。

3. 配置文件

需在项目根目录创建 .vscode 文件夹，并添加以下配置。

launch.json (调试配置):

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Debug with GDB",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/bin/cpp3.exe",
            "args": [],
            "cwd": "${workspaceFolder}",
            "MIMode": "gdb"
        }
    ]
}

*注意：请将 cpp3.exe 替换为你实际生成的可执行文件名。

settings.json (文件关联):

{
    "files.associations": {
        "xlocmes": "cpp",
        "istream": "cpp",
        "ostream": "cpp",
        "xiosbase": "cpp",
        "xutility": "cpp"
    }
}

方案三：使用 Clang 编译

1. 安装 LLVM

从 LLVM 官网 下载预编译包。安装后同样需要配置环境变量 Path，指向 bin 目录。

2. 插件配置

• Clangd (llvm-vs-code)
• CodeLLDB (vadimcn)

3. 配置文件

launch.json (LLDB 调试):

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Debug with LLDB",
            "type": "lldb",
            "request": "launch",
            "program": "${workspaceFolder}/bin/cpp3.exe",
            "args": [],
            "cwd": "${workspaceFolder}"
        }
    ]
}

实战：编译与调试流程

无论选择哪种编译器，核心步骤都围绕 CMake 展开。

1. 编写 CMakeLists.txt

在项目根目录创建此文件，定义项目名称、标准及源文件。示例如下：

cmake_minimum_required(VERSION 3.10)
project(cpp3)

# 设置 C++ 标准为 C++17
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 添加可执行文件
add_executable(${PROJECT_NAME} main.cpp)

# 设置输出目录为 bin
set(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin)

# 头文件与库路径（按需开启）
#include_directories(${PROJECT_SOURCE_DIR}/include)
#link_directories(${PROJECT_SOURCE_DIR}/lib)

2. 使用 CMake Tools 构建

打开 Trae 侧边栏的 CMake Tools 面板：

1. 选择编译器: 点击状态栏或面板中的编译器选项，扫描本机可用的工具链（如 Clang++, MSVC, MinGW）。
2. 生成构建文件: 切换编译器后，插件会自动生成对应的构建文件（如 build.ninja, .sln, Makefile）。
3. 编译: 点击状态栏的 "Build" 按钮，或右键 CMakeLists.txt 选择 "Build"。

提示: 每次更换编译器前，建议先执行 "Clean" 操作，清除旧的缓存文件，避免链接错误。

3. 启动调试

1. 在 main.cpp 关键行设置断点。
2. 切换到 "Run and Debug" 面板。
3. 选择对应的调试配置（如 "Debug with GDB" 或 "Debug with LLDB"）。
4. 点击绿色运行按钮（小虫子图标）。

此时程序将在断点处暂停，你可以查看变量值、单步执行，完成调试闭环。

常见问题排查

• 找不到编译器: 检查环境变量是否生效，尝试重启 Trae。
• 链接错误: 确认 CMakeLists.txt 中的库路径是否正确，以及是否安装了相应的 SDK。
• 调试不中断: 确保编译时开启了 -g 或 /Zi 调试符号，且 launch.json 中的 program 路径指向正确。

掌握这些基础配置后，你就能在 Trae 中高效地管理 C++ 项目了。后续可根据具体业务需求，进一步探索 CMake 的高级特性。