Debian上Rust代码风格如何统一

1. 安装Rustfmt工具
在Debian系统上，Rustfmt作为Rust官方工具链的一部分，可通过rustup（Rust版本管理工具）快速安装。打开终端，执行以下命令即可完成安装：

rustup component add rustfmt

安装完成后，可通过rustfmt --version验证是否安装成功。

2. 使用Cargo集成格式化
Cargo是Rust的项目管理与构建工具，内置了对Rustfmt的支持。通过以下命令可快速格式化项目代码：

• 格式化整个项目：在项目根目录下运行cargo fmt，该命令会递归处理项目中所有.rs文件，按照Rustfmt的默认规则调整代码格式。
• 格式化特定文件/目录：若只需格式化单个文件或指定目录，可添加路径参数，例如cargo fmt -- src/main.rs（格式化src/main.rs）或cargo fmt -- src/utils（格式化src/utils目录下所有文件）。

3. 自定义格式化配置
若需调整默认格式规则（如行宽、缩进、括号位置等），可在项目根目录下创建rustfmt.toml（或.rustfmt.toml）配置文件。常见配置项及示例：

• 缩进设置：tab_spaces = 4（强制使用4个空格缩进，禁止Tab字符）；
• 行宽限制：max_width = 100（每行代码最大长度为100字符，超过则自动换行）；
• 大括号风格：brace_style = "SameLineWhere"（函数/结构体的左大括号与声明在同一行，如fn foo() {）；
• 控制流大括号：control_brace_style = "AlwaysSameLine"（if/else等控制流的关键字后直接跟大括号，如if x > 5 {）。
  配置文件支持嵌套在项目目录或其父级目录中，优先级随目录层级升高而降低（项目目录的配置优先级最高）。

4. 集成到开发工作流
为确保团队代码风格一致，需将Rustfmt集成到日常开发与CI/CD流程中：

• 预提交钩子：使用pre-commit框架（如cargo-make或pre-commit-rust），在提交代码前自动运行cargo fmt，避免未格式化的代码进入仓库。
• CI检查：在项目的CI配置文件（如GitHub Actions、GitLab CI）中添加cargo fmt --check步骤，该命令会检查代码是否符合格式规则（若不符合则报错），确保每次提交的代码都经过格式化验证。

5. 遵循Rust官方风格指南
Rustfmt的默认规则基于Rust官方《Rust Style Guide》，该指南定义了代码布局、命名规范、注释要求等核心规则。例如：

• 命名规范：变量/函数使用蛇形命名（snake_case，如user_id、get_name）；结构体/枚举使用帕斯卡命名（PascalCase，如User、OrderStatus）；常量使用全大写蛇形命名（SCREAMING_SNAKE_CASE，如MAX_RETRY）。
• 代码组织：按功能域划分模块（而非文件类型），导入路径按“标准库→第三方库→本地模块”排序，同一组内按字母顺序排列（rustfmt会自动处理）。
• 注释规范：使用///为公共API添加文档注释，//为代码逻辑添加行内注释，避免无意义的注释。

6. 团队协作规范
在团队项目中，需统一配置文件的存放位置（建议放在项目根目录），并通过文档记录格式化规则（如README.md中添加“代码风格”章节）。定期召开代码审查会议，重点关注格式化问题，确保所有成员遵循相同的风格规范。