C++项目越写越乱？多范式混用、架构腐化，AI代码也在埋坑

做C++开发这么多年，我发现一个特别有意思的现象：很多人接手一个老项目之后，第一反应都是这代码谁写的，这么烂。

自己改着改着，代码越改越乱

今天就跟大家聊聊，为什么你的C++项目会越写越乱，以及怎么亡羊补牢。

多范式混用，写着写着就懵了

C++这门语言挺特殊的，它支持面向过程、面向对象、泛型编程、模板元编程，还有函数式编程。功能是挺强大的，但问题也来了。

你接手一个老项目，可能会看到这样的代码：

// 模块A：面向对象风格，有人喜欢这么写
class DataProcessor {
public:
    void process()
    {
        // ...
    }
};

// 模块B：C风格的过程式代码，历史遗留
struct RawBuffer {
    char* data;
    int  size;
};
void handle_buffer(RawBuffer* buf);

// 模块C：泛型编程风格，秀技术用的
template<typename T>
class Container {
    std::vector<T> items;
public:
    template<typename Func>
    void apply(Func&& f);
};

// 模块D：函数式风格，lambda满天飞
auto result = std::accumulate(
    data.begin(), data.end(),
    0, [](auto sum, const auto& item) {
        return sum + item.value;
    });

你说这代码能用吗？能用。但你想改一行，动不动就踩坑。因为你不知道下一个模块是什么风格，贸然改了就可能出问题。

要统一风格，新代码必须遵循同一个范式，老代码逐步重构。虽然这是个长期工程，但不做只会越来越烂。

Clang-Tidy 有个配置可以检测这类问题：

clang-tidy source.cpp -checks='readability-*'

配合 .clang-tidy 配置文件，可以强制要求团队成员遵循统一的代码风格。虽然不能完全解决范式混用的问题，但至少能让格式统一一些，读起来没那么分裂。

架构边界不一致

好的 架构设计 都是相似的，烂的架构各有各的烂法。

项目刚开始的时候，架构图画得漂漂亮亮的。数据层、业务层、接口层，分得清清楚楚。可等项目一上线，需求一变，时间一紧，这架构就开始千疮百孔了。

最常见的问题是跨层调用。本来应该是上层调用下层，结果写着写着，业务逻辑层直接绕过了服务层，跑到数据访问层去了。

// 业务逻辑层
class OrderService {
public:
    void createOrder(OrderData data)
    {
        // 正常应该调用订单仓储
        // 但开发嫌麻烦，直接在这儿写SQL了
        auto conn = DBPool::getConnection();
        std::string sql = "INSERT INTO orders ...";
        conn->execute(sql);  // 架构边界被破坏

        // 邮件通知也直接在这儿调用
        EmailService::send(data.email, "订单创建成功");  // 又跨了一层
    }
};

一次两次无所谓，时间长了，整个系统就变成了一个大泥球。业务逻辑和底层实现搅在一起，牵一发而动全身。

AI辅助编程

AI生成的代码风格可能和项目现有风格不一致。它可不管你团队用什么规范，生成的东西能跑就行。

不是说不能用AI，但要保持清醒。AI是辅助工具，不是替代品。生成的代码一定要review，别直接就提交了。可以在项目根目录加个 .cursorrules 或者 .clinerules 文件，把团队的代码规范写进去：

你是一名C++开发专家，遵守以下规范：
1. 禁止使用裸指针，动态内存必须通过[智能指针](https://yunpan.plus/f/25-1)管理
2. 优先使用std::unique_ptr，仅在需要共享所有权时使用shared_ptr
3. 代码必须通过clang-tidy检查
4. 函数不超过50行，单一职责原则

约束一下AI的行为，至少能让它少踩一些坑。

给大家几个建议

第一，建立代码规范并严格执行。不用搞得太复杂，但至少要统一命名风格、统一错误处理方式、统一资源管理方式。Clang-Tidy、CMake的cmake-format这些工具都能帮你检查。

第二，引入静态分析到CI流程。代码提交前跑一遍检查，把问题拦在门外。虽然一开始会有很多警告，但慢慢调教之后，代码质量会稳步提升。

第三，定期做架构review。每个季度或者每个大版本迭代之后，专门花时间审视一下架构有没有腐化。发现小问题及时修，别等到病入膏肓了再想着动大手术。

第四，谨慎使用AI编程工具。把它当成一个效率工具，而不是依赖对象。生成的代码一定要自己review一遍，理解每一行的含义再提交。

希望这些建议能帮你理清思路，让C++项目不再越写越乱。在 云栈社区 你还可以找到更多项目实战与架构参考资源。