CentOS环境下Rust脚本/项目编写规范
在CentOS系统上编写Rust脚本前，需先配置标准的开发环境：
sudo yum groupinstall "Development Tools"；rustup安装（curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh），安装后执行source $HOME/.cargo/env将Rust命令加入PATH；rustc --version（检查Rust编译器版本）和cargo --version（检查包管理器版本），确保输出正确版本信息。rustfmt：Rust官方推荐的格式化工具，可统一代码风格（如缩进、换行、运算符位置等）。默认配置符合Rust社区 idiomatic 风格（4空格缩进、不使用制表符）；+、==）前换行，提升可读性（例如：let result = some_long_function(argument1, argument2) + another_function(argument3);）；遵循Rust社区统一的命名约定，提升代码自解释性：
snake_case（蛇形命名法），如user_name、calculate_total；UPPER_SNAKE_CASE（全大写蛇形命名法），如MAX_BUFFER_SIZE、DEFAULT_TIMEOUT；is_、has_、should_等前缀开头，明确表示布尔语义（如is_playing、has_permission）；PascalCase（帕斯卡命名法），如PlaybackState、UserAccount；snake_case，如Track、Playlist。///为模块、结构体、枚举、函数等公共接口添加文档注释，首段简要描述功能，后续可补充# Examples（示例）、# Safety（unsafe块说明）等章节；//解释代码逻辑的“为什么”（而非“是什么”），如// 检查索引是否越界，避免panic；//!为模块添加顶层文档，说明模块的职责和用法。Result<T, E>：对于可能失败的操作（如文件IO、网络请求），返回Result类型而非panic，明确区分成功与失败场景；?操作符简化错误传播：在返回Result的函数中，用?自动处理错误（若错误发生则提前返回），减少嵌套代码（如let contents = File::open("file.txt")?.read_to_string()?;）；Err(PlayError::InvalidIndex)比Err("error")更有意义）。Arc<Mutex<T>>（线程安全共享可变数据）或Rc<RefCell<T>>（单线程共享可变数据）替代裸指针；borrow checker（借用检查器）确保并发访问的安全性（如&mut self表示独占可变访问，&self表示共享不可变访问）。#[cfg(test)]模块包裹测试代码，用#[test]标记测试函数（如#[test] fn test_addition() { assert_eq!(2 + 2, 4); }）；cargo test运行测试：默认运行所有测试，可通过cargo test <test_name>运行特定测试；grcov或tarpaulin等工具检查测试覆盖率，确保核心逻辑被充分覆盖。Cargo.toml：明确项目元信息（name、version、edition），合理声明依赖（如serde = { version = "1.0", features = ["derive"] }表示启用serde的派生宏）；build.rs控制编译流程：若需在编译前执行自定义逻辑（如生成绑定代码、嵌入资源），可添加build.rs文件（如println!("cargo:rustc-env=BUILD_VERSION=1.0.0");设置环境变量）；#[cfg(target_os = "linux")]等属性，针对不同平台编译不同代码（如CentOS下的特定系统调用）。clippy进行代码检查：clippy是Rust的lint工具，可检测未使用的变量、冗余代码、潜在错误等（运行cargo clippy）；cargo build --release编译项目，启用优化（如-O3），提升运行性能；perf、valgrind等工具分析内存占用和性能瓶颈（如检测内存泄漏、优化热点代码）。