openharmony-cpp

OpenHarmony C++ 编码规范

核心要求（常见陷阱）

这些规则在 OpenHarmony 中严格执行，且通常与通用 C++ 项目不同。

1. 严格的命名与格式规范

• **扩展名：**始终使用 .cpp 和 .h。
• 文件：文件名必须与类名匹配（类 Unix 风格，例如 my_class.cpp）。
• **变量：**全局变量必须以 g_ 开头（例如 g_config）。类成员必须以 _ 结尾（例如 value_）。
• 大括号：****必须采用 K&R 风格（左大括号与声明位于同一行）。
• **详情：**参见 naming_formatting.md。

2. 头文件管理

• **保护宏：**使用 #ifndef 保护宏。严禁使用 #pragma once。
• **包含：**优先使用 #include，而非前向声明，以避免隐藏依赖。
• **详情：**参见 headers_scopes.md。

3. 关键安全要求

• **输入验证：**使用外部数据前，必须验证所有数据（索引、大小、循环）。
• 内存安全：删除指针后，必须立即将其设为 nullptr。
• 位运算：仅用于无符号类型。
• **详情：**参见 secure_coding.md。

使用指南

适用场景

• **编写新代码：**生成新类或模块。
• **重构：**整理旧代码。
• **代码审查：**检查代码是否符合 OpenHarmony 标准。

参考索引

• naming_formatting.md：命名约定（g_、_）、大括号（K&R）、行长度。
• secure_coding.md：输入验证、整数安全、内存管理、禁用函数。
• class_function_design.md：构造函数、继承、现代 C++（nullptr、const）、函数长度。
• headers_scopes.md：头文件保护宏、命名空间、包含规则。