cpp-basics

🚀 C++ 开发规则

版本: v4.3.0 | 最后更新: 2026-01-22 | 作者: Cursor AI Rules

🎯 适用场景

• 高性能系统编程和底层开发
• 游戏引擎和实时图形应用
• 嵌入式系统和物联网设备
• 高频交易和金融系统
• 科学计算和数值模拟
• 跨平台桌面应用开发

🏗️ 项目结构

现代CMake项目布局

modern_cpp_project/
├── CMakeLists.txt              # 主CMake配置
├── cmake/                      # CMake模块
│   ├── CompilerWarnings.cmake
│   └── Conan.cmake
├── src/                        # 源代码
│   ├── main.cpp
│   ├── core/                   # 核心模块
│   │   ├── CMakeLists.txt
│   │   ├── include/
│   │   │   ├── core.h
│   │   │   └── types.h
│   │   └── src/
│   │       ├── core.cpp
│   │       └── types.cpp
│   └── utils/                  # 工具模块
├── tests/                      # 测试
│   ├── CMakeLists.txt
│   ├── main.cpp
│   └── core/
│       └── test_core.cpp
├── benchmarks/                 # 性能测试
├── examples/                   # 示例代码
├── docs/                       # 文档
├── conanfile.txt              # Conan依赖
├── .clang-format              # 代码格式化配置
├── .clang-tidy               # 静态分析配置
└── README.md

头文件组织

include/project_name/
├── core/                       # 核心功能头文件
│   ├── config.h               # 配置宏
│   ├── types.h                # 类型定义
│   └── interfaces/            # 接口定义
├── algorithms/                # 算法相关
├── containers/                # 容器实现
└── utilities/                 # 工具函数

📝 编码规范

现代C++特性使用 (C++11/14)

#include <iostream>
#include <memory>
#include <vector>
#include <string>
#include <functional>

// ✅ 推荐：使用智能指针和RAII
class FileHandler {
private:
    std::unique_ptr<std::FILE, std::function<void(std::FILE*)>> file_;

public:
    explicit FileHandler(const std::string& path)
        : file_(std::fopen(path.c_str(), "r"),
                [](std::FILE* f) { if (f) std::fclose(f); }) {
        if (!file_) {
            throw std::runtime_error("Failed to open file");
        }
    }

    // 使用const std::string&避免字符串拷贝
    void processLine(const std::string& line) {
        std::cout << "Processing: " << line << std::endl;
    }
};

// ✅ 推荐：使用auto和范围for
boost::optional<std::string> findUser(const std::vector<User>& users,
                                    const std::string& name) {
    for (const auto& user : users) {
        if (user.name == name) {
            return user.email;
        }
    }
    return boost::none;
}

// ✅ 推荐：使用constexpr进行编译时计算
constexpr int fibonacci(int n) {
    return (n <= 1) ? n : fibonacci(n - 1) + fibonacci(n - 2);
}