### 华为编程规范知识点详解
#### 一、排版规范
华为的编程规范非常重视代码的排版，这是为了确保代码的清晰性和可读性。以下是对文档中提到的一些关键排版规则的详细解释：
1. **程序块缩进**（¹1-1）：
- 规则说明：程序块应当采用缩进风格编写，每一级缩进使用4个空格。
- 示例不符合规范：
```c
if(!valid_ni(ni)) {
//programcode
}
repssn_ind = ssn_data[index].repssn_index;
repssn_ni = ssn_data[index].ni;
```
- 正确示范：
```c
if (!valid_ni(ni)) {
// programcode
}
repssn_ind = ssn_data[index].repssn_index;
repssn_ni = ssn_data[index].ni;
```
2. **程序块之间的空行**（¹1-2）：
- 规则说明：相对独立的程序块之间、变量声明之后必须加空行。
- 示例不符合规范：
```c
if(!valid_ni(ni)) {
//programcode
}
repssn_ind = ssn_data[index].repssn_index;
repssn_ni = ssn_data[index].ni;
```
- 正确示范：
```c
if (!valid_ni(ni)) {
// programcode
}
repssn_ind = ssn_data[index].repssn_index;
repssn_ni = ssn_data[index].ni;
```
3. **长语句的拆分**（¹1-3）：
- 规则说明：如果语句长度超过80个字符，应当在低优先级操作符处将语句拆分为多行，并将操作符置于新行开头。
- 示例不符合规范：
```c
perm_count_msg.head.len = NO7_TO_STAT_PERM_COUNT_LEN + STAT_SIZE_PER_FRAM * sizeof(_UL);
act_task_table[frame_id * STAT_TASK_CHECK_NUMBER + index].occupied = stat_poi[index].occupied;
act_task_table[taskno].duration_true_or_false = SYS_get_sccp_statistic_state(stat_item);
report_or_not_flag = ((taskno < MAX_ACT_TASK_NUMBER) && (n7stat_stat_item_valid(stat_item)) && (act_task_table[taskno].result_data != 0));
```
- 正确示范：
```c
perm_count_msg.head.len = NO7_TO_STAT_PERM_COUNT_LEN
+ STAT_SIZE_PER_FRAM * sizeof(_UL);
act_task_table[frame_id * STAT_TASK_CHECK_NUMBER + index].occupied
= stat_poi[index].occupied;
act_task_table[taskno].duration_true_or_false
= SYS_get_sccp_statistic_state(stat_item);
report_or_not_flag = ((taskno < MAX_ACT_TASK_NUMBER)
&& (n7stat_stat_item_valid(stat_item))
&& (act_task_table[taskno].result_data != 0));
```
4. **长表达式的拆分**（¹1-4）：
- 规则说明：循环、判断等语句中若有较长的表达式，则需在低优先级操作符处进行适当的划分。
- 示例不符合规范：
```c
if ((taskno < max_act_task_number) && (n7stat_stat_item_valid(stat_item))) {
// programcode
}
for (i = 0, j = 0; (i < BufferKeyword[word_index].word_length) && (j < NewKeyword.word_length); i++, j++) {
// programcode
}
```
- 正确示范：
```c
if ((taskno < max_act_task_number)
&& (n7stat_stat_item_valid(stat_item))) {
// programcode
}
for (i = 0, j = 0;
(i < BufferKeyword[word_index].word_length)
&& (j < NewKeyword.word_length);
i++, j++) {
// programcode
}
```
5. **函数参数的拆分**（¹1-5）：
- 规则说明：如果函数调用中的参数过长，则需要适当拆分。
- 示例不符合规范：
```c
n7stat_str_compare((BYTE*) &stat_object,
(BYTE*) &(act_task_table[taskno].stat_object),
sizeof(_STAT_OBJECT));
```
- 正确示范：
```c
n7stat_str_compare((BYTE*) &stat_object,
(BYTE*) &(act_task_table[taskno].stat_object),
sizeof(_STAT_OBJECT));
```
6. **单行语句**（¹1-6）：
- 规则说明：每个语句都应单独占据一行。
- 示例不符合规范：
```c
rect.length = 0; rect.width = 0;
```
- 正确示范：
```c
rect.length = 0;
rect.width = 0;
```
7. **控制语句格式**（¹1-7）：
- 规则说明：`if`、`for`、`do`、`while`、`case`、`switch`、`default`等语句自占一行，其后的执行语句无论长度如何都必须加括号 `{}`。
- 示例不符合规范：
```c
if (pUserCR == NULL) return;
```
- 正确示范：
```c
if (pUserCR == NULL) {
return;
}
```
8. **后续规范待续**（¹1-8）：
- 规则说明：文档中未给出具体规范，但可以推测该部分继续讲解关于排版的其他规范。
以上是华为编程规范中关于排版方面的主要规定。这些规范旨在提高代码的可读性和可维护性，确保代码的一致性和标准化。遵循这些规范有助于减少错误的发生，提高团队协作效率。
2025-07-04 20:32:54
264KB
1
《华为编程规范和范例》是一本面向程序员的指导书籍，旨在提高代码质量和可维护性。编程风格是软件开发中的重要组成部分，它不仅影响代码的可读性，还直接影响到团队协作的效率和项目的长期成功。华为作为全球知名的科技公司，其编程规范具有较高的权威性和实践价值。
该书可能涵盖了以下几个方面的内容：
1. **命名规范**：良好的命名能让代码自解释，降低理解难度。这包括变量名、函数名、类名等应遵循的规则，如使用有意义的英文单词或词组，避免使用缩写和单个字符命名。
2. **代码格式化**：规范代码的缩进、空格和换行，保持代码的统一性。例如，可能规定每级缩进使用几个空格，函数定义、参数和大括号的对齐方式等。
3. **注释与文档**：强调在关键位置添加注释，解释代码的功能、用途和注意事项。注释应简洁明了，避免过度注释。同时，提倡编写清晰的模块文档，如使用Doxygen或Javadoc格式。
4. **错误处理**：如何正确地捕获、处理和报告错误，避免简单的异常导致程序崩溃。建议使用异常处理机制，并提供合适的错误信息。
5. **代码结构与设计**：提倡模块化、分层设计，降低模块间的耦合度。提倡使用设计模式，如工厂模式、观察者模式等，以提升代码的灵活性和复用性。
6. **效率与性能**：在保证代码可读性的前提下，注意算法选择和优化，避免不必要的计算，减少内存占用，提升程序运行速度。
7. **版本控制**：推荐使用版本控制系统如Git，讲解如何正确提交、合并和解决冲突。
8. **测试策略**：介绍单元测试、集成测试的方法，强调测试的重要性，确保代码质量。
9. **代码审查**：鼓励团队成员进行代码审查，通过互相学习和纠正，提高整个团队的编程水平。
10. **持续集成与持续部署(CI/CD)**：简述如何利用自动化工具进行构建、测试和部署，确保快速响应变更。
通过学习《华为编程规范和范例》，程序员可以系统地提升自己的编码习惯，编写出更易于阅读、维护和扩展的代码，这对于个人职业发展和团队协作具有重要意义。书中可能还包含了大量的实例和最佳实践，帮助读者更好地理解和应用这些规范。
2025-06-27 10:27:43
599KB
1
Huawei liteos 开发指南，华为编程规范，帮助你更好的开发huawei liteos
2022-04-21 09:00:56
6.56MB
1
为规范软件开发人员的代码编写提供参考依据和统一标准。本文档适用于所有软件开发人员。为提高产品代码质量，指导广大软件开发人员编写出简洁、可维护、可靠、可测试、高效、可移植的代码，编程规范修订工作组分析、总结了我司的各种典型编码问题，并参考了业界编程规范近年来的成果，重新对我司1999年版编程规范进行了梳理、优化、刷新，编写了本规范。 本规范将分为完整版和精简版，完整版将包括更多的样例、规范的解释以及参考材料(what & why)，而精简版将只包含规则部分(what)以便查阅。 在本规范的最后，列出了一些业界比较优秀的编程规范，作为延伸阅读参考材料。
2020-01-03 11:31:03
311KB
1