Rust编码指南50条核心规则：命名规范、内存管理、并发异步最佳实践

coding-guidelines by actionbook/rust-skills

255 周安装量

974 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/actionbook/rust-skills --skill coding-guidelines

代码质量代码规范 Rust

🇨🇳中文介绍

Rust 编码指南（50 条核心规则）

命名（Rust 特有）

规则	指南
不使用 `get_` 前缀	`fn name()` 而非 `fn get_name()`
迭代器约定	`iter()` / `iter_mut()` / `into_iter()`
转换命名	`as_`（廉价引用），（昂贵），（所有权转移）

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

网页可访问性（A11y）开发指南：实现WCAG合规、键盘导航与屏幕阅读器支持

12,600 周安装

代码审查最佳实践指南：完整流程、安全与性能审查清单

12,400 周安装

测试策略完整指南：单元/集成/E2E测试金字塔与自动化实践

11,200 周安装

代码库搜索技能指南：精准查找函数、追踪依赖、理解架构与定位错误

10,900 周安装

规则	指南
使用新类型	`struct Email(String)` 用于领域语义
优先使用切片模式	`if let [first, .., last] = slice`
预分配	`Vec::with_capacity()`, `String::with_capacity()`
避免滥用 Vec	固定大小使用数组

规则	指南
优先使用字节	处理 ASCII 时用 `s.bytes()` 而非 `s.chars()`
使用 `Cow<str>`	当可能需要修改借用数据时
使用 `format!`	优于使用 `+` 的字符串拼接
避免嵌套迭代	字符串上的 `contains()` 是 O(n*m) 复杂度

规则	指南
使用 `?` 传播	而非 `try!()` 宏
`expect()` 优于 `unwrap()`	当值有保证时
使用断言处理不变量	在函数入口处使用 `assert!`

规则	指南
使用有意义的生命周期	`'src`, `'ctx` 而非仅用 `'a`
对 RefCell 使用 `try_borrow()`	避免恐慌
使用遮蔽进行转换	`let x = x.parse()?`

规则	指南
识别锁顺序	防止死锁
对基本类型使用原子操作	对 bool/usize 不使用 Mutex
谨慎选择内存顺序	Relaxed/Acquire/Release/SeqCst

规则	指南
CPU 密集型任务使用同步	异步适用于 I/O 操作
不要在 await 期间持有锁	使用作用域守卫

规则	指南
除非必要，避免使用	优先使用函数/泛型
遵循 Rust 语法	宏输入应看起来像 Rust 代码

已弃用	更优方案	自版本
`lazy_static!`	`std::sync::OnceLock`	1.70
`once_cell::Lazy`	`std::sync::LazyLock`	1.80
`std::sync::mpsc`	`crossbeam::channel`	-
`std::sync::Mutex`	`parking_lot::Mutex`	-
`failure`/`error-chain`	`thiserror`/`anyhow`	-
`try!()`	`?` 运算符	2018

🇺🇸English

Rust Coding Guidelines (50 Core Rules)

Naming (Rust-Specific)

Rule	Guideline
No `get_` prefix	`fn name()` not `fn get_name()`
Iterator convention	`iter()` / `iter_mut()` / `into_iter()`
Conversion naming	`as_` (cheap &), `to_` (expensive), `into_` (ownership)
Static var prefix	`G_CONFIG` for `static`, no prefix for `const`

Data Types

Rule	Guideline
Use newtypes	`struct Email(String)` for domain semantics
Prefer slice patterns	`if let [first, .., last] = slice`
Pre-allocate	`Vec::with_capacity()`, `String::with_capacity()`
Avoid Vec abuse	Use arrays for fixed sizes

Strings

Rule	Guideline
Prefer bytes	`s.bytes()` over `s.chars()` when ASCII
Use `Cow<str>`	When might modify borrowed data
Use `format!`	Over string concatenation with `+`
Avoid nested iteration	`contains()` on string is O(n*m)

Error Handling

Rule	Guideline
Use `?` propagation	Not `try!()` macro
`expect()` over `unwrap()`	When value guaranteed
Assertions for invariants	`assert!` at function entry

Memory

Rule	Guideline
Meaningful lifetimes	`'src`, `'ctx` not just `'a`
`try_borrow()` for RefCell	Avoid panic
Shadowing for transformation	`let x = x.parse()?`

Concurrency

Rule	Guideline
Identify lock ordering	Prevent deadlocks
Atomics for primitives	Not Mutex for bool/usize
Choose memory order carefully	Relaxed/Acquire/Release/SeqCst

Async

Rule	Guideline
Sync for CPU-bound	Async is for I/O
Don't hold locks across await	Use scoped guards

Macros

Rule	Guideline
Avoid unless necessary	Prefer functions/generics
Follow Rust syntax	Macro input should look like Rust

Deprecated → Better

Deprecated	Better	Since
`lazy_static!`	`std::sync::OnceLock`	1.70
`once_cell::Lazy`	`std::sync::LazyLock`	1.80
`std::sync::mpsc`	`crossbeam::channel`	-
`std::sync::Mutex`

Quick Reference

Naming: snake_case (fn/var), CamelCase (type), SCREAMING_CASE (const)
Format: rustfmt (just use it)
Docs: /// for public items, //! for module docs
Lint: #![warn(clippy::all)]

Claude knows Rust conventions well. These are the non-obvious Rust-specific rules.

Weekly Installs

Repository

actionbook/rust-skills

GitHub Stars

828

First Seen

Jan 23, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

gemini-cli45

codex44

opencode42

github-copilot39

claude-code37

cursor35