Rust Patterns

affaan-m/ECC/docs/tr/skills/rust-patterns

作者 affaan-mef648e01899ba3e8dc6371642deaaf64b4477775无许可证275K 个星标收录于 2026年10月9日更新于 2026年10月9日仓库4天前更新

Idiomatic Rust patterns, ownership, error handling, traits, concurrency, and best practices for building safe, performant applications.

仅含说明Software Development
AI 生成的概览

关于地道 Rust 模式的参考指南：所有权、错误处理、trait、并发与 crate 结构。

功能
提供地道 Rust 开发的参考指南，涵盖所有权与借用、使用 Result、thiserror 和 anyhow 的错误处理、枚举与模式匹配、trait 与泛型、迭代器、使用 Arc/Mutex 的并发、channel 与 async、unsafe 代码规则，以及模块与 crate 布局。其中包含对比正反做法的代码示例、惯用法速查表和反模式清单。还列出了用于构建、测试、lint 和审计的常用 cargo 命令。
适用场景
适用于编写新的 Rust 代码、审查现有 Rust 代码、重构 Rust，或设计 crate 结构与模块组织。适合需要地道约定和错误处理指导，而非特定库 API 的场景。
运行要求
不附带脚本或工具，仅为说明性内容。示例中提及 thiserror、anyhow、tokio、reqwest 等 Rust crate 以及 cargo 命令，但阅读这些指导本身不需要任何依赖。

Rust Geliştirme Desenleri

Güvenli, performanslı ve bakım yapılabilir uygulamalar oluşturmak için idiomatic Rust desenleri ve en iyi uygulamalar.

Ne Zaman Kullanılır

  • Yeni Rust kodu yazma
  • Rust kodunu inceleme
  • Mevcut Rust kodunu refactor etme
  • Crate yapısı ve modül düzenini tasarlama

Nasıl Çalışır

Bu skill altı ana alanda idiomatic Rust kurallarını zorlar: derleme zamanında veri yarışlarını önlemek için ownership ve borrowing, kütüphaneler için thiserror ve uygulamalar için anyhow ile Result/? hata yayılımı, yasadışı durumları temsil edilemez yapmak için enum'lar ve kapsamlı desen eşleştirme, sıfır maliyetli soyutlama için trait'ler ve generic'ler, Arc<Mutex<T>>, channel'lar ve async/await ile güvenli eşzamanlılık ve domain'e göre düzenlenmiş minimal pub yüzeyleri.

Temel İlkeler

1. Ownership ve Borrowing

Rust'ın ownership sistemi derleme zamanında veri yarışlarını ve bellek hatalarını önler.

rust
// İyi: Ownership'e ihtiyacınız olmadığında referansları geçirinfn process(data: &[u8]) -> usize {    data.len()}
// İyi: Saklamak veya tüketmek için ownership alınfn store(data: Vec<u8>) -> Record {    Record { payload: data }}
// Kötü: Borrow checker'dan kaçınmak için gereksiz clonefn process_bad(data: &Vec<u8>) -> usize {    let cloned = data.clone(); // İsraf — sadece borrow alın    cloned.len()}

Esnek Ownership için Cow Kullanın

rust
use std::borrow::Cow;
fn normalize(input: &str) -> Cow<'_, str> {    if input.contains(' ') {        Cow::Owned(input.replace(' ', "_"))    } else {        Cow::Borrowed(input) // Mutasyon gerekmediğinde sıfır maliyet    }}

Hata İşleme

Result ve ? Kullanın — Production'da Asla unwrap() Kullanmayın

rust
// İyi: Hataları context ile yayınuse anyhow::{Context, Result};
fn load_config(path: &str) -> Result<Config> {    let content = std::fs::read_to_string(path)        .with_context(|| format!("failed to read config from {path}"))?;    let config: Config = toml::from_str(&content)        .with_context(|| format!("failed to parse config from {path}"))?;    Ok(config)}
// Kötü: Hata durumunda panicfn load_config_bad(path: &str) -> Config {    let content = std::fs::read_to_string(path).unwrap(); // Panic!    toml::from_str(&content).unwrap()}

Kütüphane Hataları için thiserror, Uygulama Hataları için anyhow

rust
// Kütüphane kodu: yapılandırılmış, tiplendirilmiş hatalaruse thiserror::Error;
#[derive(Debug, Error)]pub enum StorageError {    #[error("record not found: {id}")]    NotFound { id: String },    #[error("connection failed")]    Connection(#[from] std::io::Error),    #[error("invalid data: {0}")]    InvalidData(String),}
// Uygulama kodu: esnek hata işlemeuse anyhow::{bail, Result};
fn run() -> Result<()> {    let config = load_config("app.toml")?;    if config.workers == 0 {        bail!("worker count must be > 0");    }    Ok(())}

İç İçe Eşleştirme Yerine Option Combinator'ları

rust
// İyi: Combinator zincirifn find_user_email(users: &[User], id: u64) -> Option<String> {    users.iter()        .find(|u| u.id == id)        .map(|u| u.email.clone())}
// Kötü: Derinlemesine iç içe eşleştirmefn find_user_email_bad(users: &[User], id: u64) -> Option<String> {    match users.iter().find(|u| u.id == id) {        Some(user) => match &user.email {            email => Some(email.clone()),        },        None => None,    }}

Enum'lar ve Desen Eşleştirme

Durumları Enum'lar Olarak Modelleyin

rust
// İyi: İmkansız durumlar temsil edilemezenum ConnectionState {    Disconnected,    Connecting { attempt: u32 },    Connected { session_id: String },    Failed { reason: String, retries: u32 },}
fn handle(state: &ConnectionState) {    match state {        ConnectionState::Disconnected => connect(),        ConnectionState::Connecting { attempt } if *attempt > 3 => abort(),        ConnectionState::Connecting { .. } => wait(),        ConnectionState::Connected { session_id } => use_session(session_id),        ConnectionState::Failed { retries, .. } if *retries < 5 => retry(),        ConnectionState::Failed { reason, .. } => log_failure(reason),    }}

Kapsamlı Eşleştirme — İş Mantığı için Catch-All Yok

rust
// İyi: Her varyantı açıkça işlematch command {    Command::Start => start_service(),    Command::Stop => stop_service(),    Command::Restart => restart_service(),    // Yeni bir varyant eklemek burada işlemeyi zorlar}
// Kötü: Wildcard yeni varyantları gizlermatch command {    Command::Start => start_service(),    _ => {} // Stop, Restart ve gelecek varyantları sessizce yok sayar}

Trait'ler ve Generic'ler

Generic Girişleri Kabul Et, Somut Türleri Döndür

rust
// İyi: Generic girdi, somut çıktıfn read_all(reader: &mut impl Read) -> std::io::Result<Vec<u8>> {    let mut buf = Vec::new();    reader.read_to_end(&mut buf)?;    Ok(buf)}
// İyi: Birden fazla kısıtlama için trait bound'larıfn process<T: Display + Send + 'static>(item: T) -> String {    format!("processed: {item}")}

Dinamik Dispatch için Trait Object'leri

rust
// Heterojen koleksiyonlara veya plugin sistemlerine ihtiyacınız olduğunda kullanıntrait Handler: Send + Sync {    fn handle(&self, request: &Request) -> Response;}
struct Router {    handlers: Vec<Box<dyn Handler>>,}
// Performansa ihtiyacınız olduğunda generic'leri kullanın (monomorfizasyon)fn fast_process<H: Handler>(handler: &H, request: &Request) -> Response {    handler.handle(request)}

Tip Güvenliği için Newtype Deseni

rust
// İyi: Farklı tipler argümanları karıştırmayı önlerstruct UserId(u64);struct OrderId(u64);
fn get_order(user: UserId, order: OrderId) -> Result<Order> {    // User ve order ID'lerini yanlışlıkla değiştiremezsiniz    todo!()}
// Kötü: Argümanları değiştirmek kolayfn get_order_bad(user_id: u64, order_id: u64) -> Result<Order> {    todo!()}

Struct'lar ve Veri Modelleme

Karmaşık Yapılandırma için Builder Deseni

rust
struct ServerConfig {    host: String,    port: u16,    max_connections: usize,}
impl ServerConfig {    fn builder(host: impl Into<String>, port: u16) -> ServerConfigBuilder {        ServerConfigBuilder { host: host.into(), port, max_connections: 100 }    }}
struct ServerConfigBuilder { host: String, port: u16, max_connections: usize }
impl ServerConfigBuilder {    fn max_connections(mut self, n: usize) -> Self { self.max_connections = n; self }    fn build(self) -> ServerConfig {        ServerConfig { host: self.host, port: self.port, max_connections: self.max_connections }    }}
// Kullanım: ServerConfig::builder("localhost", 8080).max_connections(200).build()

Iterator'lar ve Closure'lar

Manuel Döngüler Yerine Iterator Zincirlerini Tercih Edin

rust
// İyi: Deklaratif, lazy, birleştirilebilirlet active_emails: Vec<String> = users.iter()    .filter(|u| u.is_active)    .map(|u| u.email.clone())    .collect();
// Kötü: İmperatif biriktirmelet mut active_emails = Vec::new();for user in &users {    if user.is_active {        active_emails.push(user.email.clone());    }}

Tip Annotation ile collect() Kullanın

rust
// Farklı tiplere collect etlet names: Vec<_> = items.iter().map(|i| &i.name).collect();let lookup: HashMap<_, _> = items.iter().map(|i| (i.id, i)).collect();let combined: String = parts.iter().copied().collect();
// Result'ları collect et — ilk hatada kısa devre yaparlet parsed: Result<Vec<i32>, _> = strings.iter().map(|s| s.parse()).collect();

Eşzamanlılık

Paylaşılan Mutable State için Arc<Mutex<T>>

rust
use std::sync::{Arc, Mutex};
let counter = Arc::new(Mutex::new(0));let handles: Vec<_> = (0..10).map(|_| {    let counter = Arc::clone(&counter);    std::thread::spawn(move || {        let mut num = counter.lock().expect("mutex poisoned");        *num += 1;    })}).collect();
for handle in handles {    handle.join().expect("worker thread panicked");}

Mesaj Geçişi için Channel'lar

rust
use std::sync::mpsc;
let (tx, rx) = mpsc::sync_channel(16); // Backpressure ile bounded channel
for i in 0..5 {    let tx = tx.clone();    std::thread::spawn(move || {        tx.send(format!("message {i}")).expect("receiver disconnected");    });}drop(tx); // Sender'ı kapat böylece rx iterator sonlanır
for msg in rx {    println!("{msg}");}

Tokio ile Async

rust
use tokio::time::Duration;
async fn fetch_with_timeout(url: &str) -> Result<String> {    let response = tokio::time::timeout(        Duration::from_secs(5),        reqwest::get(url),    )    .await    .context("request timed out")?    .context("request failed")?;
    response.text().await.context("failed to read body")}
// Eşzamanlı görevler spawn etasync fn fetch_all(urls: Vec<String>) -> Vec<Result<String>> {    let handles: Vec<_> = urls.into_iter()        .map(|url| tokio::spawn(async move {            fetch_with_timeout(&url).await        }))        .collect();
    let mut results = Vec::with_capacity(handles.len());    for handle in handles {        results.push(handle.await.unwrap_or_else(|e| panic!("spawned task panicked: {e}")));    }    results}

Unsafe Kod

Unsafe Ne Zaman Kabul Edilebilir

rust
// Kabul edilebilir: Belgelenmiş değişmezlerle FFI sınırı (Rust 2024+)/// # Safety/// `ptr` başlatılmış bir `Widget`'a geçerli, hizalı bir pointer olmalıdır.unsafe fn widget_from_raw<'a>(ptr: *const Widget) -> &'a Widget {    // SAFETY: çağıran ptr'nin geçerli ve hizalı olduğunu garanti eder    unsafe { &*ptr }}
// Kabul edilebilir: Doğruluk kanıtı ile performans-kritik yol// SAFETY: döngü sınırı nedeniyle index her zaman < lenunsafe { slice.get_unchecked(index) }

Unsafe Ne Zaman Kabul EDİLEMEZ

rust
// Kötü: Borrow checker'ı atlamak için unsafe kullanma// Kötü: Kolaylık için unsafe kullanma// Kötü: Safety yorumu olmadan unsafe kullanma// Kötü: İlgisiz tipler arasında transmute etme

Modül Sistemi ve Crate Yapısı

Tipe Göre Değil, Domain'e Göre Düzenle

text
my_app/├── src/│   ├── main.rs│   ├── lib.rs│   ├── auth/          # Domain modülü│   │   ├── mod.rs│   │   ├── token.rs│   │   └── middleware.rs│   ├── orders/        # Domain modülü│   │   ├── mod.rs│   │   ├── model.rs│   │   └── service.rs│   └── db/            # Altyapı│       ├── mod.rs│       └── pool.rs├── tests/             # Entegrasyon testleri├── benches/           # Benchmark'lar└── Cargo.toml

Görünürlük — Minimal Şekilde Açığa Çıkarın

rust
// İyi: Dahili paylaşım için pub(crate)pub(crate) fn validate_input(input: &str) -> bool {    !input.is_empty()}
// İyi: lib.rs'den public API'yi yeniden export etpub mod auth;pub use auth::AuthMiddleware;
// Kötü: Her şeyi pub yapmakpub fn internal_helper() {} // pub(crate) veya private olmalı

Araç Entegrasyonu

Temel Komutlar

bash
# Build ve kontrolcargo buildcargo check              # Codegen olmadan hızlı tip kontrolücargo clippy             # Lint'ler ve önerilercargo fmt                # Kodu formatla
# Test etmecargo testcargo test -- --nocapture    # println çıktısını göstercargo test --lib             # Sadece unit testlercargo test --test integration # Sadece entegrasyon testleri
# Bağımlılıklarcargo audit              # Güvenlik denetimicargo tree               # Bağımlılık ağacıcargo update             # Bağımlılıkları güncelle
# Performanscargo bench              # Benchmark'ları çalıştır

Hızlı Referans: Rust Deyimleri

DeyimAçıklama
Clone etme, borrow alOwnership gerekmedikçe clone yerine &T geçir
Yasadışı durumları temsil edilemez yapSadece geçerli durumları modellemek için enum'ları kullan
unwrap() yerine ?Hataları yay, kütüphane/production kodunda asla panic
Validate etme, parse etSınırda yapılandırılmamış veriyi tiplendirilmiş struct'lara dönüştür
Tip güvenliği için newtypeArgüman değişimlerini önlemek için primitive'leri newtype'lara sar
Döngüler yerine iterator'ları tercih etDeklaratif zincirler daha net ve genellikle daha hızlı
Result'larda #[must_use]Çağıranların dönüş değerlerini işlemesini garanti et
Esnek ownership için CowBorrow yeterli olduğunda allocation'lardan kaçın
Kapsamlı eşleştirmeİş-kritik enum'lar için wildcard _ yok
Minimal pub yüzeyiDahili API'ler için pub(crate) kullan

Kaçınılacak Anti-Desenler

rust
// Kötü: Production kodunda .unwrap()let value = map.get("key").unwrap();
// Kötü: Nedenini anlamadan borrow checker'ı tatmin etmek için .clone()let data = expensive_data.clone();process(&original, &data);
// Kötü: &str yeterken String kullanmafn greet(name: String) { /* &str olmalı */ }
// Kötü: Kütüphanelerde Box<dyn Error> (yerine thiserror kullanın)fn parse(input: &str) -> Result<Data, Box<dyn std::error::Error>> { todo!() }
// Kötü: must_use uyarılarını yok saymalet _ = validate(input); // Bir Result'ı sessizce atma
// Kötü: Async context'te bloke etmeasync fn bad_async() {    std::thread::sleep(Duration::from_secs(1)); // Executor'ı bloke eder!    // Kullanın: tokio::time::sleep(Duration::from_secs(1)).await;}

Unutmayın: Derlenir ise muhtemelen doğrudur — ama sadece unwrap() kullanmaktan kaçınır, unsafe'i minimize eder ve tip sisteminin sizin için çalışmasına izin verirseniz.

来源与署名

来源：affaan-m/ECC位于docs/tr/skills/rust-patterns提交ef648e0

许可证： 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架

更多来自 affaan-m/ECC 的技能

Unified Notifications Ops

affaan-m

设计统一的通知策略，对来自 GitHub、Linear、钩子和聊天工具的通知进行分类、路由、去重和升级。

Productivity & Workflow275K4天前更新

Verification Loop

affaan-m

执行六阶段代码验证流程，并生成 PASS/FAIL 就绪报告。

Software Development275K4天前更新

Ui To Vue

affaan-m

将批量 UI 设计截图转换为使用 Vant、Element Plus 或 Ant Design Vue 的 Vue 3 组件。

Software Development275K4天前更新

Unified Memory

affaan-m

指导智能体通过本地 ECC Memory Vault 在不同执行框架之间共享持久上下文与交接信息。

AI & Agents275K4天前更新

Visa Doc Translate

affaan-m

通过 OCR 将签证文件图片翻译成英文，并生成原图与译文对照的双语 PDF。

Documents & Office275K4天前更新

Team Builder

affaan-m

交互式选择器：发现可用的智能体角色，让用户最多选择五个，并行执行同一任务并汇总结果。

AI & Agents275K4天前更新

更多Software Development技能

Playground

anthropics

精选

构建自包含的交互式 HTML 演练场，包含控件、实时预览和可复制的提示词输出。

Software Development37K今天更新

M5 Onboard

anthropics

精选

通过 USB 检测 M5Stack ESP32 开发板，刷写 UIFlow 2.0 固件并安装 MicroPython 应用包。

Software Development37K今天更新

Cardputer Buddy

anthropics

精选

指导迭代 Cardputer-Adv 的 MicroPython 应用包：添加应用、通过 USB 串口推送文件、查看日志并运行 REPL 命令。

Software Development37K今天更新

Web Design Guidelines

vercel-labs

精选

依据从远程来源获取的 Web Interface Guidelines 审查 UI 代码，并以 file:line 形式报告问题。

Software Development32K5周前更新

Vercel React Native Skills

vercel-labs

精选

React Native 与 Expo 最佳实践规则，涵盖列表性能、动画、导航、UI 模式、状态与 monorepo 配置。

Software Development32K5周前更新

Vercel React Best Practices

vercel-labs

精选

Vercel 的 React 与 Next.js 性能指南，以 70 条规则的形式用于编写、审查和重构代码。

Software Development32K5周前更新