ECC C 模式指南从 RAII 到错误处理的现代 C 实战规范【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC本文是 ECCThe agent harness performance optimization system规则体系中的 C 模式patterns专项指南聚焦于 C 开发中最核心的四大设计主题RAII 资源管理、五法则/零法则、值语义与错误处理。结合 ECC 仓库内 rules/cpp/patterns.md 与 skills/cpp-coding-standards/SKILL.md 的源码级规范读者将掌握可落地的现代 CC17/20/23编码模式并理解这些规则在 Agent 辅助编码/评审场景中如何被触发与强制执行。规则文件的定位语言层如何扩展通用层在 ECC 的规则体系中规则被组织为common 通用层 语言专属层两层结构详见 rules/README.mdrules/ ├── common/ # 语言无关原则始终安装 │ └── patterns.md └── cpp/ # C 专属规则 ├── patterns.md # ← 本文主题 ├── coding-style.md ├── hooks.md ├── security.md └── testing.mdrules/cpp/patterns.md的职责非常明确它扩展而非重复通用层的 rules/common/patterns.md后者聚焦于骨架项目选择、Repository 模式、API 响应封装等语言无关设计模式用 C 特有的内容进行补充。文档开头明确声明This file extends common/patterns.md with C specific content.按照 ECC 的规则优先级设计当语言专属规则与通用规则冲突时语言专属规则优先类似 CSS 特异性或.gitignore优先级这保证了 C 习惯用法不会被通用模式覆盖。规则触发条件Frontmatter paths每个语言规则文件头部都带有 frontmatterpaths元数据定义了该规则在 Agent 工作流中自动生效的文件匹配范围paths: - **/*.cpp - **/*.hpp - **/*.cc - **/*.hh - **/*.cxx - **/*.h - **/CMakeLists.txt这意味着当 Agent 在编写、评审或重构任何.cpp/.hpp/.cc/.hh/.cxx/.h源码或CMakeLists.txt构建脚本时本模式规则都会被加载并作为评审依据。RAII将资源生命周期绑定到对象生命周期RAIIResource Acquisition Is Initialization资源获取即初始化是 C 区别于其他语言最核心的资源管理哲学。其本质是资源的获取发生在对象构造时资源的释放发生在对象析构时从而让编译器自动保证资源的释放杜绝泄漏。rules/cpp/patterns.md给出的最小范例是一个文件句柄封装class FileHandle { public: explicit FileHandle(const std::string path) : file_(std::fopen(path.c_str(), r)) {} ~FileHandle() { if (file_) std::fclose(file_); } FileHandle(const FileHandle) delete; FileHandle operator(const FileHandle) delete; private: std::FILE* file_; };注意几个关键设计点explicit单参数构造函数防止std::string到FileHandle的隐式转换对应 C Core Guidelines 的C.46规则析构函数负责释放无论控制流如何正常返回、抛出异常、break/continue析构函数都会被调用资源必然释放删除拷贝构造/拷贝赋值FILE*是裸指针浅拷贝会导致 double-free因此显式 delete禁止拷贝把类设计成 move-only可配合std::exchange实现移动语义。源码级深化完整版 RAII 实现在 skills/cpp-coding-standards/SKILL.md 的R.* 资源管理章节中给出了更完整的 RAII 类实现对应规则R.1用 RAII 自动管理资源// R.1: Resource acquisition is initialization class FileHandle { public: explicit FileHandle(const std::string path) : handle_(std::fopen(path.c_str(), r)) { if (!handle_) throw std::runtime_error(Failed to open: path); } ~FileHandle() { if (handle_) std::fclose(handle_); } FileHandle(const FileHandle) delete; FileHandle operator(const FileHandle) delete; FileHandle(FileHandle other) noexcept : handle_(std::exchange(other.handle_, nullptr)) {} FileHandle operator(FileHandle other) noexcept { if (this ! other) { if (handle_) std::fclose(handle_); handle_ std::exchange(other.handle_, nullptr); } return *this; } private: std::FILE* handle_; };相比基础版完整版补齐了资源获取失败时的异常抛出throw std::runtime_error与移动语义利用std::exchange转移句柄并置空源对象。这正对应异常安全与所有权转移的完整闭环。在E.* 错误处理部分RAII 也被列为防泄漏的基石E.6Use RAII to prevent leaks在CP.* 并发部分RAII 同样延伸到锁管理CP.20Use RAII, never plainlock()/unlock()可见 RAII 是贯穿整个 C Core Guidelines 的横切原则对应 Guideline 编号 P.8、R.1、E.6、CP.20。智能指针RAII 的现代形态规则文件与 skill 都强调现代 C 应使用智能指针替代裸new/deleteR.11并遵循以下取舍R.20/R.21/R.22// R.11 R.20 R.21: RAII with smart pointers auto widget std::make_uniqueWidget(config); // 独占所有权 auto cache std::make_sharedCache(1024); // 共享所有权 // R.3: 裸指针 非拥有观察者 void render(const Widget* w) { // 不拥有 w if (w) w-draw(); } render(widget.get());std::unique_ptr是默认选择独占所有权零额外开销std::shared_ptr仅在真正需要共享所有权时使用R.21裸指针只允许作为非拥有的观察者R.3绝不传递所有权I.11优先std::make_unique/std::make_shared避免裸new与异常安全风险R.22且make_shared减少一次内存分配。零法则与五法则特殊成员函数的管理策略规则文件定义了 C 中最容易被忽视的类设计决策零法则Rule of Zero优先使用不需要自定义析构函数、拷贝/移动构造函数或赋值运算符的类。让编译器生成正确的特殊成员函数五法则Rule of Five如果必须定义析构函数、拷贝构造函数、拷贝赋值、移动构造函数、移动赋值中的任意一个就必须全部定义五个。对应 C Core Guidelines 的C.20能避免定义默认操作就避免即零法则与C.21定义了任意拷贝/移动/析构就必须处理全部五个。零法则示例// C.20: Let the compiler generate special members struct Employee { std::string name; std::string department; int id; // 无需析构函数、拷贝/移动构造函数、赋值运算符 };当成员本身都是 RAII 类型如std::string、std::vector且没有需要手工管理的资源时编译器生成的默认操作完全正确手写特殊成员函数反而是引入 bug 的源头例如漏写移动操作导致拷贝开销、手写析构破坏移动语义。五法则示例// C.21: If you must manage a resource, define all five class Buffer { public: explicit Buffer(std::size_t size) : data_(std::make_uniquechar[](size)), size_(size) {} ~Buffer() default; Buffer(const Buffer other) : data_(std::make_uniquechar[](other.size_)), size_(other.size_) { std::copy_n(other.data_.get(), size_, data_.get()); } Buffer operator(const Buffer other) { if (this ! other) { auto new_data std::make_uniquechar[](other.size_); std::copy_n(other.data_.get(), other.size_, new_data.get()); data_ std::move(new_data); size_ other.size_; } return *this; } Buffer(Buffer) noexcept default; Buffer operator(Buffer) noexcept default; private: std::unique_ptrchar[] data_; std::size_t size_; };这个Buffer类完整呈现了五法则的意图深拷贝拷贝构造与拷贝赋值都通过std::make_unique重新分配并std::copy_n复制数据拷贝赋值采用 copy-and-swap 风格先构造临时再移动赋值天然具备强异常安全移动 default即可因为unique_ptr本身就是可移动的noexcept移动操作让std::vectorBuffer扩容时能走移动而非拷贝。相关反模式来自 skill在构造函数/析构函数中调用虚函数C.82对非平凡类型使用memset/memcpyC.90数据成员声明为const或引用从而禁用移动/拷贝C.12虚基类与重写函数提供不同的默认参数C.140。另外注意在多态类中还应抑制公开拷贝/移动C.67基类析构函数要么是public virtual要么是protected non-virtualC.35避免通过基类指针删除派生类对象时发生未定义行为。值语义传参、返回与移动的黄金法则规则文件给出值语义的四条指导原则小/平凡类型按值传递——例如int、double、std::pair这类廉价拷贝类型大型类型按const传递——例如std::string、std::vector这类昂贵拷贝类型按值返回依赖 RVO/NRVO 消除拷贝对 sink 参数接收后即被消耗的参数使用移动语义。源码级深化参数传递F.16与返回F.20/F.21skill 中 F.* 函数章节给出了可复制的完整范式// F.16: 廉价类型按值昂贵类型按 const void print(int x); // 廉价按值 void analyze(const std::string data); // 昂贵按 const void transform(std::string s); // sink按值将会移动 // F.20 F.21: 返回结构体而非输出参数 struct ParseResult { std::string token; int position; }; ParseResult parse(std::string_view input); // 好返回结构体 // 差输出参数应避免 void parse(std::string_view input, std::string token, int pos); // avoid this要点解读sink 参数按值传递调用方传std::move(s)时参数直接移动构造避免额外拷贝传左值时则拷贝语义清晰且不会悬垂优先返回值而非输出参数F.20现代编译器通过 RVOReturn Value Optimization保证按值返回零拷贝返回std::string、std::vector这类自带移动语义的类型移动开销也极小多返回值用结构体F.21比输出参数更清晰也避免参数顺序错误纯函数与 constexprF.4/F.8可能编译期求值的函数声明为constexpr// F.4 F.8: Pure, constexpr where possible constexpr int factorial(int n) noexcept { return (n 1) ? 1 : n * factorial(n - 1); } static_assert(factorial(5) 120);值语义相关反模式返回TF.45——悬垂引用风险返回const TF.49——抑制移动语义使用 C 风格变参va_argF.55在传递给其他线程的 lambda 中按引用捕获F.53。错误处理异常、optional 与 expected 的三层分工规则文件给出了 C 错误处理的分层策略这是现代 C 最重要的设计决策之一异常情况exceptional conditions使用异常exceptions——函数无法完成其任务时抛出可能不存在的值使用std::optional——例如查找结果、解析可选字段返回值可能没有但并非错误预期失败expected failures使用std::expectedC23或结果类型——例如网络请求失败、文件解析失败这类调用方应主动处理的场景用错误码/结果类型显式返回。这一分层与 docs/ja-JP/rules/cpp/coding-style.md 中现代 C 优先于 C 风格语法的导向一致C 语言的errno 返回值约定E.28 反模式被彻底替代。源码级深化异常层级设计E.14/E.15/E.17skill 的 E.* 章节提供了符合规范的异常类型设计// E.14 E.15: 自定义异常类型按值抛出按引用捕获 class AppError : public std::runtime_error { public: using std::runtime_error::runtime_error; }; class NetworkError : public AppError { public: NetworkError(const std::string msg, int code) : AppError(msg), status_code(code) {} int status_code; }; void fetch_data(const std::string url) { // E.2: 抛出异常以表明失败 throw NetworkError(connection refused, 503); } void run() { try { fetch_data(https://api.example.com); } catch (const NetworkError e) { log_error(e.what(), e.status_code); } catch (const AppError e) { log_error(e.what()); } // E.17: 不要在这里捕获一切——让意外错误向上传播 }设计要点异常类型有明确意图E.14NetworkError携带status_code调用方可以按具体类型分别处理按值抛出、按引用捕获E.15避免切片slicing风险catch (const NetworkError)优先于更宽的catch (const AppError)不吞异常E.17不要在每个函数里catch (...)空吞错误无法处理的错误应传播给上层noexcept的正确使用E.12/E.16析构函数、释放操作、swap 必须noexcept且永不失败。错误处理反模式清单抛出内建类型如int、字符串字面量作为异常E.14按值捕获存在切片风险E.15空catch块静默吞掉错误用异常做流程控制E.3依赖errno等全局状态做错误处理E.28。模式规则如何融入 ECC 的 C 开发闭环C 模式文件并非孤立存在它是 ECC C 规则族patterns / coding-style / hooks / security / testing的一员与技能层cpp-coding-standards协同工作rules/cpp/coding-style.md补充了资源管理禁用手工new/delete、make_unique/make_shared优先、命名规范类型 PascalCase、函数 snake_case/camelCase、常量 kPascalCase 或 UPPER_SNAKE_CASE、成员snake_case_或m_前缀、格式化强制clang-format -i file杜绝风格争论等约定cpp-coding-standards技能skills/cpp-coding-standards/SKILL.md提供基于 C Core Guidelines 的完整规则矩阵覆盖 PhilosophyP.*、InterfacesI.*、FunctionsF.*、ClassesC.*、ResourcesR.*、Expressions StatementsES.*、Error HandlingE.*、Constants ImmutabilityCon.*、ConcurrencyCP.*、TemplatesT.*、Standard LibrarySL.*、EnumerationsEnum.*、Source Files NamingSF.*/NL.*、PerformancePer.*共 14 大领域并附随一个完成前检查清单Quick Reference Checklist——这是 Agent 评审 C 代码时的可直接引用的核对表规则层与技能层的关系正如 rules/README.md 所述Rules 告诉你做什么标准与清单Skills 告诉你怎么做可操作的深度参考资料。安装与使用方式如果你需要在本地 Claude Code / Codex 等 Agent 环境中启用这套规则可以按 rules/README.md 的方式安装以用户级为例mkdir -p ~/.claude/rules/ecc # 安装通用规则所有项目必需 cp -r rules/common ~/.claude/rules/ecc/ # 安装语言专属规则按项目技术栈选择 cp -r rules/cpp ~/.claude/rules/ecc/注意必须整目录拷贝而非/*展开因为 common 与语言目录存在同名文件如patterns.md扁平化会导致语言专属文件覆盖通用规则并破坏语言文件中对../common/的相对引用。实战速查C 模式规则要点一览主题核心要点对应 GuidelineRAII资源生命周期绑定对象生命周期析构自动释放P.8, R.1, E.6, CP.20智能指针unique_ptr默认shared_ptr按需裸指针仅观察R.11, R.20, R.21, R.22零法则无自定义资源管理的类让编译器生成特殊成员C.20五法则定义其一则五者皆备C.21值语义小类型按值、大类型const、按值返回、sink 移动F.16, F.20, F.21异常仅异常情况抛出按值抛、按引用捕、不空吞E.2, E.14, E.15, E.17可选值std::optional表示可能不存在—预期失败std::expectedC23或结果类型显式返回—这套模式规则是 Agent 在编写、评审与重构 C 代码时的硬性基准RAII 杜绝资源泄漏零/五法则杜绝特殊成员函数陷阱值语义杜绝无谓拷贝与悬垂引用错误处理分层则让失败路径清晰可预测。结合cpp-coding-standards技能中的完整规则矩阵与检查清单即可在现代 C 项目中系统化落地这些经过 C Core Guidelines 验证的实践。【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 ECC C++ 模式指南：从 RAII 到错误处理的现代 C++ 实战规范
ECC C 模式指南从 RAII 到错误处理的现代 C 实战规范【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC本文是 ECCThe agent harness performance optimization system规则体系中的 C 模式patterns专项指南聚焦于 C 开发中最核心的四大设计主题RAII 资源管理、五法则/零法则、值语义与错误处理。结合 ECC 仓库内 rules/cpp/patterns.md 与 skills/cpp-coding-standards/SKILL.md 的源码级规范读者将掌握可落地的现代 CC17/20/23编码模式并理解这些规则在 Agent 辅助编码/评审场景中如何被触发与强制执行。规则文件的定位语言层如何扩展通用层在 ECC 的规则体系中规则被组织为common 通用层 语言专属层两层结构详见 rules/README.mdrules/ ├── common/ # 语言无关原则始终安装 │ └── patterns.md └── cpp/ # C 专属规则 ├── patterns.md # ← 本文主题 ├── coding-style.md ├── hooks.md ├── security.md └── testing.mdrules/cpp/patterns.md的职责非常明确它扩展而非重复通用层的 rules/common/patterns.md后者聚焦于骨架项目选择、Repository 模式、API 响应封装等语言无关设计模式用 C 特有的内容进行补充。文档开头明确声明This file extends common/patterns.md with C specific content.按照 ECC 的规则优先级设计当语言专属规则与通用规则冲突时语言专属规则优先类似 CSS 特异性或.gitignore优先级这保证了 C 习惯用法不会被通用模式覆盖。规则触发条件Frontmatter paths每个语言规则文件头部都带有 frontmatterpaths元数据定义了该规则在 Agent 工作流中自动生效的文件匹配范围paths: - **/*.cpp - **/*.hpp - **/*.cc - **/*.hh - **/*.cxx - **/*.h - **/CMakeLists.txt这意味着当 Agent 在编写、评审或重构任何.cpp/.hpp/.cc/.hh/.cxx/.h源码或CMakeLists.txt构建脚本时本模式规则都会被加载并作为评审依据。RAII将资源生命周期绑定到对象生命周期RAIIResource Acquisition Is Initialization资源获取即初始化是 C 区别于其他语言最核心的资源管理哲学。其本质是资源的获取发生在对象构造时资源的释放发生在对象析构时从而让编译器自动保证资源的释放杜绝泄漏。rules/cpp/patterns.md给出的最小范例是一个文件句柄封装class FileHandle { public: explicit FileHandle(const std::string path) : file_(std::fopen(path.c_str(), r)) {} ~FileHandle() { if (file_) std::fclose(file_); } FileHandle(const FileHandle) delete; FileHandle operator(const FileHandle) delete; private: std::FILE* file_; };注意几个关键设计点explicit单参数构造函数防止std::string到FileHandle的隐式转换对应 C Core Guidelines 的C.46规则析构函数负责释放无论控制流如何正常返回、抛出异常、break/continue析构函数都会被调用资源必然释放删除拷贝构造/拷贝赋值FILE*是裸指针浅拷贝会导致 double-free因此显式 delete禁止拷贝把类设计成 move-only可配合std::exchange实现移动语义。源码级深化完整版 RAII 实现在 skills/cpp-coding-standards/SKILL.md 的R.* 资源管理章节中给出了更完整的 RAII 类实现对应规则R.1用 RAII 自动管理资源// R.1: Resource acquisition is initialization class FileHandle { public: explicit FileHandle(const std::string path) : handle_(std::fopen(path.c_str(), r)) { if (!handle_) throw std::runtime_error(Failed to open: path); } ~FileHandle() { if (handle_) std::fclose(handle_); } FileHandle(const FileHandle) delete; FileHandle operator(const FileHandle) delete; FileHandle(FileHandle other) noexcept : handle_(std::exchange(other.handle_, nullptr)) {} FileHandle operator(FileHandle other) noexcept { if (this ! other) { if (handle_) std::fclose(handle_); handle_ std::exchange(other.handle_, nullptr); } return *this; } private: std::FILE* handle_; };相比基础版完整版补齐了资源获取失败时的异常抛出throw std::runtime_error与移动语义利用std::exchange转移句柄并置空源对象。这正对应异常安全与所有权转移的完整闭环。在E.* 错误处理部分RAII 也被列为防泄漏的基石E.6Use RAII to prevent leaks在CP.* 并发部分RAII 同样延伸到锁管理CP.20Use RAII, never plainlock()/unlock()可见 RAII 是贯穿整个 C Core Guidelines 的横切原则对应 Guideline 编号 P.8、R.1、E.6、CP.20。智能指针RAII 的现代形态规则文件与 skill 都强调现代 C 应使用智能指针替代裸new/deleteR.11并遵循以下取舍R.20/R.21/R.22// R.11 R.20 R.21: RAII with smart pointers auto widget std::make_uniqueWidget(config); // 独占所有权 auto cache std::make_sharedCache(1024); // 共享所有权 // R.3: 裸指针 非拥有观察者 void render(const Widget* w) { // 不拥有 w if (w) w-draw(); } render(widget.get());std::unique_ptr是默认选择独占所有权零额外开销std::shared_ptr仅在真正需要共享所有权时使用R.21裸指针只允许作为非拥有的观察者R.3绝不传递所有权I.11优先std::make_unique/std::make_shared避免裸new与异常安全风险R.22且make_shared减少一次内存分配。零法则与五法则特殊成员函数的管理策略规则文件定义了 C 中最容易被忽视的类设计决策零法则Rule of Zero优先使用不需要自定义析构函数、拷贝/移动构造函数或赋值运算符的类。让编译器生成正确的特殊成员函数五法则Rule of Five如果必须定义析构函数、拷贝构造函数、拷贝赋值、移动构造函数、移动赋值中的任意一个就必须全部定义五个。对应 C Core Guidelines 的C.20能避免定义默认操作就避免即零法则与C.21定义了任意拷贝/移动/析构就必须处理全部五个。零法则示例// C.20: Let the compiler generate special members struct Employee { std::string name; std::string department; int id; // 无需析构函数、拷贝/移动构造函数、赋值运算符 };当成员本身都是 RAII 类型如std::string、std::vector且没有需要手工管理的资源时编译器生成的默认操作完全正确手写特殊成员函数反而是引入 bug 的源头例如漏写移动操作导致拷贝开销、手写析构破坏移动语义。五法则示例// C.21: If you must manage a resource, define all five class Buffer { public: explicit Buffer(std::size_t size) : data_(std::make_uniquechar[](size)), size_(size) {} ~Buffer() default; Buffer(const Buffer other) : data_(std::make_uniquechar[](other.size_)), size_(other.size_) { std::copy_n(other.data_.get(), size_, data_.get()); } Buffer operator(const Buffer other) { if (this ! other) { auto new_data std::make_uniquechar[](other.size_); std::copy_n(other.data_.get(), other.size_, new_data.get()); data_ std::move(new_data); size_ other.size_; } return *this; } Buffer(Buffer) noexcept default; Buffer operator(Buffer) noexcept default; private: std::unique_ptrchar[] data_; std::size_t size_; };这个Buffer类完整呈现了五法则的意图深拷贝拷贝构造与拷贝赋值都通过std::make_unique重新分配并std::copy_n复制数据拷贝赋值采用 copy-and-swap 风格先构造临时再移动赋值天然具备强异常安全移动 default即可因为unique_ptr本身就是可移动的noexcept移动操作让std::vectorBuffer扩容时能走移动而非拷贝。相关反模式来自 skill在构造函数/析构函数中调用虚函数C.82对非平凡类型使用memset/memcpyC.90数据成员声明为const或引用从而禁用移动/拷贝C.12虚基类与重写函数提供不同的默认参数C.140。另外注意在多态类中还应抑制公开拷贝/移动C.67基类析构函数要么是public virtual要么是protected non-virtualC.35避免通过基类指针删除派生类对象时发生未定义行为。值语义传参、返回与移动的黄金法则规则文件给出值语义的四条指导原则小/平凡类型按值传递——例如int、double、std::pair这类廉价拷贝类型大型类型按const传递——例如std::string、std::vector这类昂贵拷贝类型按值返回依赖 RVO/NRVO 消除拷贝对 sink 参数接收后即被消耗的参数使用移动语义。源码级深化参数传递F.16与返回F.20/F.21skill 中 F.* 函数章节给出了可复制的完整范式// F.16: 廉价类型按值昂贵类型按 const void print(int x); // 廉价按值 void analyze(const std::string data); // 昂贵按 const void transform(std::string s); // sink按值将会移动 // F.20 F.21: 返回结构体而非输出参数 struct ParseResult { std::string token; int position; }; ParseResult parse(std::string_view input); // 好返回结构体 // 差输出参数应避免 void parse(std::string_view input, std::string token, int pos); // avoid this要点解读sink 参数按值传递调用方传std::move(s)时参数直接移动构造避免额外拷贝传左值时则拷贝语义清晰且不会悬垂优先返回值而非输出参数F.20现代编译器通过 RVOReturn Value Optimization保证按值返回零拷贝返回std::string、std::vector这类自带移动语义的类型移动开销也极小多返回值用结构体F.21比输出参数更清晰也避免参数顺序错误纯函数与 constexprF.4/F.8可能编译期求值的函数声明为constexpr// F.4 F.8: Pure, constexpr where possible constexpr int factorial(int n) noexcept { return (n 1) ? 1 : n * factorial(n - 1); } static_assert(factorial(5) 120);值语义相关反模式返回TF.45——悬垂引用风险返回const TF.49——抑制移动语义使用 C 风格变参va_argF.55在传递给其他线程的 lambda 中按引用捕获F.53。错误处理异常、optional 与 expected 的三层分工规则文件给出了 C 错误处理的分层策略这是现代 C 最重要的设计决策之一异常情况exceptional conditions使用异常exceptions——函数无法完成其任务时抛出可能不存在的值使用std::optional——例如查找结果、解析可选字段返回值可能没有但并非错误预期失败expected failures使用std::expectedC23或结果类型——例如网络请求失败、文件解析失败这类调用方应主动处理的场景用错误码/结果类型显式返回。这一分层与 docs/ja-JP/rules/cpp/coding-style.md 中现代 C 优先于 C 风格语法的导向一致C 语言的errno 返回值约定E.28 反模式被彻底替代。源码级深化异常层级设计E.14/E.15/E.17skill 的 E.* 章节提供了符合规范的异常类型设计// E.14 E.15: 自定义异常类型按值抛出按引用捕获 class AppError : public std::runtime_error { public: using std::runtime_error::runtime_error; }; class NetworkError : public AppError { public: NetworkError(const std::string msg, int code) : AppError(msg), status_code(code) {} int status_code; }; void fetch_data(const std::string url) { // E.2: 抛出异常以表明失败 throw NetworkError(connection refused, 503); } void run() { try { fetch_data(https://api.example.com); } catch (const NetworkError e) { log_error(e.what(), e.status_code); } catch (const AppError e) { log_error(e.what()); } // E.17: 不要在这里捕获一切——让意外错误向上传播 }设计要点异常类型有明确意图E.14NetworkError携带status_code调用方可以按具体类型分别处理按值抛出、按引用捕获E.15避免切片slicing风险catch (const NetworkError)优先于更宽的catch (const AppError)不吞异常E.17不要在每个函数里catch (...)空吞错误无法处理的错误应传播给上层noexcept的正确使用E.12/E.16析构函数、释放操作、swap 必须noexcept且永不失败。错误处理反模式清单抛出内建类型如int、字符串字面量作为异常E.14按值捕获存在切片风险E.15空catch块静默吞掉错误用异常做流程控制E.3依赖errno等全局状态做错误处理E.28。模式规则如何融入 ECC 的 C 开发闭环C 模式文件并非孤立存在它是 ECC C 规则族patterns / coding-style / hooks / security / testing的一员与技能层cpp-coding-standards协同工作rules/cpp/coding-style.md补充了资源管理禁用手工new/delete、make_unique/make_shared优先、命名规范类型 PascalCase、函数 snake_case/camelCase、常量 kPascalCase 或 UPPER_SNAKE_CASE、成员snake_case_或m_前缀、格式化强制clang-format -i file杜绝风格争论等约定cpp-coding-standards技能skills/cpp-coding-standards/SKILL.md提供基于 C Core Guidelines 的完整规则矩阵覆盖 PhilosophyP.*、InterfacesI.*、FunctionsF.*、ClassesC.*、ResourcesR.*、Expressions StatementsES.*、Error HandlingE.*、Constants ImmutabilityCon.*、ConcurrencyCP.*、TemplatesT.*、Standard LibrarySL.*、EnumerationsEnum.*、Source Files NamingSF.*/NL.*、PerformancePer.*共 14 大领域并附随一个完成前检查清单Quick Reference Checklist——这是 Agent 评审 C 代码时的可直接引用的核对表规则层与技能层的关系正如 rules/README.md 所述Rules 告诉你做什么标准与清单Skills 告诉你怎么做可操作的深度参考资料。安装与使用方式如果你需要在本地 Claude Code / Codex 等 Agent 环境中启用这套规则可以按 rules/README.md 的方式安装以用户级为例mkdir -p ~/.claude/rules/ecc # 安装通用规则所有项目必需 cp -r rules/common ~/.claude/rules/ecc/ # 安装语言专属规则按项目技术栈选择 cp -r rules/cpp ~/.claude/rules/ecc/注意必须整目录拷贝而非/*展开因为 common 与语言目录存在同名文件如patterns.md扁平化会导致语言专属文件覆盖通用规则并破坏语言文件中对../common/的相对引用。实战速查C 模式规则要点一览主题核心要点对应 GuidelineRAII资源生命周期绑定对象生命周期析构自动释放P.8, R.1, E.6, CP.20智能指针unique_ptr默认shared_ptr按需裸指针仅观察R.11, R.20, R.21, R.22零法则无自定义资源管理的类让编译器生成特殊成员C.20五法则定义其一则五者皆备C.21值语义小类型按值、大类型const、按值返回、sink 移动F.16, F.20, F.21异常仅异常情况抛出按值抛、按引用捕、不空吞E.2, E.14, E.15, E.17可选值std::optional表示可能不存在—预期失败std::expectedC23或结果类型显式返回—这套模式规则是 Agent 在编写、评审与重构 C 代码时的硬性基准RAII 杜绝资源泄漏零/五法则杜绝特殊成员函数陷阱值语义杜绝无谓拷贝与悬垂引用错误处理分层则让失败路径清晰可预测。结合cpp-coding-standards技能中的完整规则矩阵与检查清单即可在现代 C 项目中系统化落地这些经过 C Core Guidelines 验证的实践。【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考