C++ 综合最佳实践清单

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

// ============================================================
// 条款 1：理解模板类型推导
// ============================================================
template<typename T>
void deduceRef(T&& param) {
    // T&& 是万能引用（forwarding reference）
    std::cout << "  推导类型: " << typeid(T).name() << "\n";
}

// ============================================================
// 条款 5：优先使用 auto 而非显式类型
// ============================================================
void autoVsExplicit() {
    // ✅ 避免无意的类型不匹配
    std::vector<int> v{1, 2, 3};
    auto sz = v.size();         // size_t，与平台一致
    // unsigned sz = v.size();  // ❌ 32位平台可能溢出
}

// ============================================================
// 条款 9：优先使用别名声明而非 typedef
// ============================================================
template<typename T>
using UserList = std::vector<T>;  // ✅ 别名模板

// template<typename T>
// typedef std::vector<T> UserListOld;  // ❌ 编译错误

// ============================================================
// 条款 12：为意在覆盖的函数加上 override
// ============================================================
class Base {
public:
    virtual void process(int id) { /*...*/ }
    virtual ~Base() = default;
};

class Derived : public Base {
public:
    void process(int id) override { /*...*/ }  // ✅ 编译期检查
    // void process(unsigned id) override;      // ❌ 编译错误，签名不匹配
};

// ============================================================
// 条款 17：理解特殊成员函数的生成规则
// ============================================================
class RuleOfFive {
public:
    RuleOfFive() = default;
    ~RuleOfFive() = default;

    RuleOfFive(const RuleOfFive&) = default;            // 拷贝构造
    RuleOfFive& operator=(const RuleOfFive&) = default; // 拷贝赋值
    RuleOfFive(RuleOfFive&&) noexcept = default;        // 移动构造
    RuleOfFive& operator=(RuleOfFive&&) noexcept = default; // 移动赋值
};

// ============================================================
// 条款 23：理解 std::move 和 std::forward
// ============================================================
template<typename T>
decltype(auto) forwardExample(T&& param) {
    // std::move：无条件转换到右值
    // std::forward：条件转换（仅当实参是右值）
    return std::forward<T>(param);  // ✅ 完美转发
}

// ============================================================
// 条款 30：熟悉完美转发失败的情况
// ============================================================
// 以下场景完美转发可能失败：
// 1. 花括号初始化器：f({1,2,3}) 无法推导
// 2. 0 或 NULL 作为空指针：会被推导为整数
// 3. 重载函数名和模板名：歧义
// 4. 位域：不能绑定到引用

// ============================================================
// 飞翔科技代码审查检查单 (Code Review Checklist)
// ============================================================
void codeReviewChecklist() {
    // ☐ 用 auto 替代冗长类型声明
    // ☐ 用 nullptr 替代 NULL/0
    // ☐ 用 enum class 替代裸 enum
    // ☐ 所有虚函数覆盖都加 override
    // ☐ 不可继承的类加 final
    // ☐ 不抛异常的函数标记 noexcept
    // ☐ 移动构造/赋值标记 noexcept
    // ☐ 优先 unique_ptr，需要共享才用 shared_ptr
    // ☐ 避免裸 new/delete
    // ☐ 用 {} 统一初始化语法
    // ☐ 用 constexpr 替代宏常量
    // ☐ 用 static_assert 做编译期检查
    // ☐ Lambda 捕获明确：避免 [=] 和 [&] 通配
    // ☐ 多线程用 task-based (async) 而非 thread-based
    // ☐ 数据成员在声明处初始化
    // ☐ 函数参数：只读用 const&，消耗用 &&
    // ☐ 用 std::string_view 替代 const std::string& (C++17)
    // ☐ 用 [[nodiscard]] 标记不应忽略返回值的函数
}

int main() {
    std::cout << "=== 飞翔科技 C++ 最佳实践 ===\n\n";

    // auto 类型推导
    const int x = 42;
    auto a = x;          // int（const 被去掉）
    auto& b = x;         // const int&
    decltype(auto) c = x; // const int（保留 const）

    std::cout << "auto a = const int: " << typeid(a).name() << "\n";
    std::cout << "auto& b = const int: " << typeid(b).name() << "\n";

    // nullptr
    int* p = nullptr;  // ✅ 类型安全
    // int n = NULL;   // ❌ 歧义：是 0 还是空指针？

    // enum class
    enum class Status { OK, WARN, ERROR };
    Status s = Status::OK;
    // int x = Status::OK;  // ❌ 不隐式转换
    int y = static_cast<int>(Status::OK);  // ✅ 显式转换

    std::cout << "\nStatus::OK = " << static_cast<int>(s) << "\n";

    // [[nodiscard]] (C++17)
    auto getConfig = []() [[nodiscard]] -> int { return 42; };
    auto val = getConfig();  // ✅ 使用返回值
    // getConfig();          // ⚠️ 编译器警告：忽略返回值

    // 用 {} 初始化防止窄化
    int arr[] = {1, 2, 3};           // ✅
    // int n{3.14};                   // ❌ 窄化错误
    double d{42};                    // ✅ 加宽安全

    std::cout << "\n所有检查项通过\n";
}

// ============================================================
// 命名规范
// ============================================================
class UserService           {};  // 类名：PascalCase
struct Point3D             {};  // 结构体：PascalCase
enum class ColorCode       {};  // 枚举：PascalCase

void processUserRequest();       // 函数：camelCase
int  user_id_;                   // 成员变量：snake_case_
const int kMaxConnections = 100; // 常量：k + PascalCase

// ============================================================
// 头文件规范
// ============================================================
// ✅ 使用 #pragma once
#pragma once

// ✅ 包含顺序：相关头文件 → 标准库 → 第三方 → 项目内
// #include "user_service.h"
// #include <string>
// #include <vector>

// ============================================================
// 异常安全保证
// ============================================================
template<typename T>
class SafeResource {
public:
    explicit SafeResource(T* ptr) : ptr_(ptr) {}
    ~SafeResource() { delete ptr_; }

    SafeResource(const SafeResource&) = delete;
    SafeResource& operator=(const SafeResource&) = delete;
    SafeResource(SafeResource&& other) noexcept
        : ptr_(other.ptr_) {
        other.ptr_ = nullptr;
    }

private:
    T* ptr_;
};

auto x = {1, 2, 3};     // x 是 std::initializer_list<int>
auto y{1};               // C++17: y 是 int
// 避免：用 auto 配合大括号时注意推导规则差异

const auto& result = getHeavyObject();  // ✅ 避免拷贝
auto result = getHeavyObject();         // ❌ 可能触发拷贝

template<typename T>
class Wrapper {
    Wrapper(const Wrapper&) = default;  // 在模板中等同于 = delete？
    // 正确做法：显式用 SFINAE 或 requires
};