1. 遵循Rust官方风格指南
Rust官方提供的风格指南是Debian上Rust开发的底层准则，涵盖缩进、命名、注释等基础要求。核心规则包括：使用4个空格缩进（禁用Tab字符）；结构体、枚举、特质采用PascalCase（如UserProfile、FromStr），变量、函数、方法使用snake_case（如calculate_area、parse_input），常量用全大写字母+下划线（如MAX_RETRIES、CONFIG_PATH）；公共API（结构体、函数、trait）必须用///编写文档注释，说明功能、参数、返回值及示例。
2. 使用自动化工具保障一致性
Debian环境下，通过rustfmt（格式化）和Clippy（静态检查）实现风格自动化管控。rustfmt可自动调整代码格式（如缩进、换行），命令cargo fmt会格式化项目所有Rust文件；Clippy检查潜在错误（如未使用的变量）及不符合最佳实践的代码（如滥用clone），命令cargo clippy执行检查。团队项目可通过持续集成（CI）配置（如GitHub Actions），在每次推送时自动运行cargo fmt -- --check（检查格式）和cargo clippy -- -D warnings（禁止警告），确保代码风格统一。
3. 项目配置与依赖管理规范
使用Cargo作为项目管理和构建工具，创建项目用cargo new project_name，依赖通过Cargo.toml管理。依赖项应按crate名称字母顺序排序，避免内联表（如version = "0.4.38"单独一行），减少不必要的依赖（如仅在测试中使用#[cfg(test)]标记的crate）。例如：
[dependencies]
dioxus = "0.5.1"
dioxus-core = "0.5.1"
smallvec = "1.13.2"
[dependencies.chrono]
version = "0.4.38"
features = ["serde"]
4. 代码格式化细节规范
let shape_dirty = ShapeDirty::new(logger.sub("shape_dirty"), on_dirty.clone())拆分为两行，先定义sub_logger再初始化shape_dirty）；use super::{ConnectionPool, Executor}; // 子模块
use crate::{bail, error::Error}; // 当前crate
use serde::de::DeserializeOwned; // 外部依赖
use std::{fmt::Display, sync::atomic::Ordering::Relaxed}; // 标准库
// === Transform ===）前留3个空行，结构体/函数前留1个空行，文件末尾留1个空行；:）后加空格，逗号、操作符（如=、+）周围加空格（如fn test(foo: String)、let foo = a + b * c）。5. 文档与注释规范
///编写，遵循Rustdoc规范。结构需包含：单行摘要（如/// 计算矩形的面积）、详细描述（可选，说明功能、场景）、参数（/// * width：矩形的宽度）、返回值（/// 返回矩形的面积）及示例（rust\nlet area = calculate_area(5.0, 10.0);\nassert_eq!(area, 50.0);\n）；6. 错误处理与安全规范
Result类型（如Result<Self, Error>），避免使用unwrap()（仅限测试代码）；优先使用?操作符传递错误，而非手动match；unsafe代码（可在项目根目录添加#![forbid(unsafe_code)]禁止）；定期更新依赖（cargo update），修复已知安全漏洞。7. 测试与CI/CD集成
#[test]标记），例如：#[test]
fn test_calculate_area() {
assert_eq!(calculate_area(5.0, 10.0), 50.0);
}
cargo test（测试）、cargo fmt -- --check（格式化检查）、cargo clippy -- -D warnings（静态检查），确保代码质量。
