Rust 开发规范 参考来源:Rust API Guidelines、Rust Async Book、tokio.rs、Axum 官方示例、Effective Rust 适用范围 :后端 Web 服务(Axum + Tokio 路线)。CLI/wasm/嵌入式不在本规范覆盖范围内。 --- 工具链 edition :新项目默认 ,老项目保持 不强迁。 版本基线 (写死,避免重复决策): - Tokio ,Axum ,tower-http - serde 、tracing 、tracing-subscriber - DB:sqlx (runtime-tokio-rustls) --- 命名约定 | 类型 | 规则 | 示例 | |------|------|------| | 模块/文件 | snake case | | | 函数/变量 | snake case | , | | 类型/Trait/Enum | UpperCamelCase | , | | 常量/静态 | SCREAMING SNAKE CASE | | | 泛型 | 单大写或 UpperCamelCase | , , | | 生命周期 | 短小写 | , | 禁止 : 、 、 、 等无意义模块名。模块按职责命名( 、 、 )。 --- 模块组织 参照 / 的实证拆分,按职责切文件, 不堆 : 可见性 : 优先于 。…