Rust 常用函数/方法/语法速查手册

用途：写代码时随手查，不用每次都去翻官方文档。按"我要干什么"分类，不是按语言特性分类，方便直接定位。

目录

1. 字符串处理（String / &str）
2. 数字与类型转换
3. Vec 常用方法
4. HashMap 常用方法
5. Option 常用方法
6. Result 常用方法
7. 迭代器常用方法
8. 输入输出（io）
9. 常用语法糖 / 技巧
10. 格式化打印速查（{} 里能写什么）
11. 常见类型速查表
12. 网络编程常用（std::net）
13. 常见报错对照表

1. 字符串处理（String / &str）

先搞清楚 String 和 &str 的关系：String 是"拥有所有权、可增长"的字符串（存在堆上）；&str 是"借用的字符串切片"（只读，不拥有数据）。字符串字面量 "abc" 的类型就是 &str。函数参数优先写 &str（更通用，String 能自动转成 &str 传进去）。

记忆技巧：凡是"看一眼、判断"的方法（len/is_empty/contains/starts_with），签名都是 &self；凡是"改内容"的（push_str/insert_str），签名都是 &mut self；凡是"生成新字符串"的（replace/to_uppercase），都返回一个全新的 String，不改原字符串。

2. 数字与类型转换

记忆技巧：as 转换是"暴力转换"，超出目标类型范围会出乱码般的错误结果（不会报错，是"静默"出错，最容易埋雷）；try_from 是"安全转换"，超范围直接给你 Err，写校验逻辑（比如端口号范围检查）优先用 try_from 或手动比较范围。

3. Vec 常用方法

记忆技巧：v[i] 越界直接崩程序（panic），v.get(i) 越界给你 None——处理不确定来源的下标（比如用户输入的索引）一定用 .get()，不要直接用 []。

4. HashMap 常用方法

use std::collections::HashMap;

记忆技巧：entry().or_insert() 是统计计数的标准套路（"没有就建、有就累加"），几乎每个用HashMap做统计的场景都会用到，务必记熟。遍历顺序不保证，需要有序输出要额外 .sort() 或换 BTreeMap。

5. Option 常用方法

记忆技巧：.map() 是"有值就加工一下，还是Option"；.and_then() 是"有值就调用一个'本身也返回Option'的函数，避免出现Option<Option>这种嵌套"。

6. Result 常用方法

记忆技巧：正式代码里，尽量不用 unwrap()，改用 match、?、或者 .unwrap_or(默认值)；只有在写原型/测试代码，图快的时候才用 unwrap()。expect(msg) 比 unwrap() 稍好一点，至少panic时能看到你写的提示信息，方便定位问题。

7. 迭代器常用方法

先转成迭代器：.iter()（借用）/ .into_iter()（拿走所有权）/ .iter_mut()（可变借用）

记忆技巧：迭代器方法都是"链式调用"，可以一直 . 下去（v.iter().filter(...).map(...).collect()），中间过程都是"懒执行"（不会立刻算），只有调用了 .collect()/.count()/.sum() 这类"消费型"方法才会真正触发计算——这个特性叫"惰性求值"，性能上比每一步都生成中间Vec要好。

8. 输入输出（io）

use std::io;

9. 常用语法糖 / 技巧

// if let：只关心Option/Result的一种情况时，比match简洁
if let Some(x) = opt {
    println!("{}", x);
}

// while let：循环处理，直到不满足模式为止（比如不断从Vec里pop）
while let Some(x) = stack.pop() {
    println!("{}", x);
}

// ? 运算符：错误/None向上传播（第6章重点）
let x = risky()?;

// 元组解构
let (a, b) = (1, 2);
let (min, max) = (ports.iter().min(), ports.iter().max());

// 数组/Vec的模式匹配（match）
match arr.as_slice() {
    [] => println!("空"),
    [x] => println!("只有一个: {}", x),
    [first, .., last] => println!("首:{} 尾:{}", first, last),
}

// 用 _ 忽略不需要的值
let (_, port) = ("192.168.1.1", 8080);
for _ in 0..3 { /* 不需要循环变量时 */ }

// 链式Option/Result判断多个条件（match guard）
match port {
    p if p < 1024 => println!("知名端口"),
    p if p < 49152 => println!("注册端口"),
    _ => println!("动态端口"),
}

// 一行式条件表达式（if是表达式，有返回值）
let status = if port == 80 { "http" } else { "other" };

// 结构体更新语法：基于已有实例创建新实例，只改部分字段
let t2 = Target { port: 443, ..t1 };

// #[derive(...)] 自动实现常用trait，不用手写
#[derive(Debug, Clone, PartialEq)]
struct Target { ip: String, port: u16 }
// Debug: 支持 {:?} 打印
// Clone: 支持 .clone()
// PartialEq: 支持 == 比较

10. 格式化打印速查（{} 里能写什么）

println!("{}", x);        // Display格式（人类可读）
println!("{:?}", x);      // Debug格式（调试用，需要类型支持）
println!("{:#?}", x);     // 美化的Debug格式，多行缩进
println!("{:5}", x);      // 最小宽度5，右对齐（数字默认）补空格
println!("{:<5}", x);     // 左对齐，宽度5
println!("{:>5}", x);     // 右对齐，宽度5
println!("{:^5}", x);     // 居中，宽度5
println!("{:05}", x);     // 宽度5，不足补0（常用于格式化IP/端口对齐）
println!("{:.2}", f);     // 浮点数保留2位小数
println!("{:x}", n);      // 十六进制小写（网络包分析常用）
println!("{:X}", n);      // 十六进制大写
println!("{:08x}", n);    // 十六进制，宽度8，补0（常见于格式化MAC地址/十六进制dump）
println!("{:b}", n);      // 二进制
println!("{:o}", n);      // 八进制
println!("{name}", name=x);  // 具名参数
println!("{0} {1} {0}", a, b); // 按位置索引，可重复引用

11. 常见类型速查表

12. 网络编程常用（std::net）

use std::net::{TcpStream, TcpListener, SocketAddr, IpAddr, Ipv4Addr};
use std::time::Duration;

// 建立TCP连接（阻塞，一直等到成功或失败）
let stream = TcpStream::connect("127.0.0.1:8080");

// 建立TCP连接，带超时（网络工具里更常用，避免一直卡住）
let addr: SocketAddr = "127.0.0.1:8080".parse().unwrap();
let stream = TcpStream::connect_timeout(&addr, Duration::from_millis(500));

// 监听端口（写服务端/简单的listener时用）
let listener = TcpListener::bind("0.0.0.0:8080").unwrap();
for stream in listener.incoming() {
    // 处理每个连接
}

// 手动构造IP地址
let ip = Ipv4Addr::new(192, 168, 1, 1);

// 判断字符串是不是合法IP
let is_valid: bool = "192.168.1.1".parse::<IpAddr>().is_ok();

reqwest（HTTP客户端，需要额外加依赖）常用写法：

// 同步（简单场景）
// Cargo.toml: reqwest = { version = "0.12", features = ["blocking"] }
let resp = reqwest::blocking::get("https://example.com")?;
println!("{}", resp.status());
println!("{}", resp.text()?);

// 异步（推荐，性能更好）
// Cargo.toml: reqwest = "0.12", tokio = { version = "1", features = ["full"] }
let resp = reqwest::get("https://example.com").await?;
let body = resp.text().await?;

13. 常见报错对照表

使用建议：这份手册按"我要干什么"分类，不用背，遇到问题先想"我要做的事属于哪一类"（字符串处理？集合操作？错误处理？），来这里对应章节查表，比每次都搜索引擎慢慢翻要快。写多了自然就记住了。