docs: 修复了贡献文档,重新对 README 排版
This commit is contained in:
@@ -75,18 +75,16 @@
|
||||
|
||||
## 🎨 代码风格
|
||||
|
||||
- 使用 **C++17** 标准。
|
||||
- 缩进统一为 **4 空格**。
|
||||
- 文件名统一小写,单词用下划线分隔(如 `event_loop.h`)。
|
||||
- 类名采用 **大驼峰命名**(如 `EventLoop`)。
|
||||
- 函数与变量采用 **小写加下划线**(如 `start_server()`,`buffer_size`)。
|
||||
- 公共接口需要写清楚 **Doxygen 风格注释**。
|
||||
详见 [代码规范](code_style.md)
|
||||
|
||||
---
|
||||
|
||||
## 🔍 Code Review 原则
|
||||
|
||||
详见 [代码规范](code_style.md)
|
||||
- 确认代码可读、可维护,避免冗余实现。
|
||||
- 注意异常处理、内存管理和线程安全问题。
|
||||
- 保证接口一致性和合理性。
|
||||
- 审查通过后,才能合并到 `dev` 分支。
|
||||
|
||||
---
|
||||
|
||||
|
||||
+8
-6
@@ -6,7 +6,7 @@
|
||||
|
||||
- 使用 **C++17** 或更高版本。
|
||||
- 优先使用标准库功能,避免非必要的第三方依赖。
|
||||
- 引入第三方依赖时,若有 CMake 或 Github 仓库时应避免直接复制文件于本项目。
|
||||
- 引入第三方依赖时,若有 CMake 或 Github 仓库时应避免 **直接复制文件于本项目**。
|
||||
|
||||
## 2. 文件与目录命名
|
||||
|
||||
@@ -126,7 +126,7 @@
|
||||
```cpp
|
||||
int sum = a + b;
|
||||
```
|
||||
- 控制语句中除单语句及 `do while` 外均需要添加大括号作用域:
|
||||
- 控制语句中除单语句及 `do while` 外均需要 **添加大括号作用域**:
|
||||
- 条件分支
|
||||
```cpp
|
||||
// Wrong!
|
||||
@@ -212,18 +212,20 @@
|
||||
3. 第三方库头文件
|
||||
4. 其他模块头文件
|
||||
|
||||
模块内部的头文件应当利用 CMake 配置后 **使用尖括号而非双引号** 包含。
|
||||
|
||||
示例:
|
||||
```cpp
|
||||
#include "tcp_server.hpp"
|
||||
#include <server/tcp_server.hpp>
|
||||
|
||||
#include <vector>
|
||||
#include <string>
|
||||
#include <iostream>
|
||||
|
||||
#include "third_party/some_c_lib.h"
|
||||
#include "third_party/some_cpp_lib.hpp"
|
||||
#include <third_party/some_c_lib.h>
|
||||
#include <third_party/some_cpp_lib.hpp>
|
||||
|
||||
#include "event_loop.hpp"
|
||||
#include <event/event_loop.hpp>
|
||||
```
|
||||
|
||||
## 10. 测试与调试
|
||||
|
||||
Reference in New Issue
Block a user