[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7BFHCPX0X1DP4T1TF5K3TFR":3,"skill-same:01M7BFHCPX0X1DP4T1TF5K3TFR":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":30,"ownerHtmlUrl":31,"ownerBlogUrl":6,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M7BFHCPX0X1DP4T1TF5K3TFR","rust-testing",null,"Rust测试模式，包括单元测试、集成测试、异步测试、基于属性的测试、模拟和覆盖率。遵循TDD方法学。","YYC-Cube\u002FYYC3-Knowledge-Base","YYC-Cube","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F235006543?v=4","01M79J2PH4SWD2X0825X6PN748","yyc3","01M79J2PHVK3F6ZBYT8K2SCZCW",1,"MIT","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-AI-应用工具\u002FYYC3-AI-应用工具-Everything-claude-code\u002Fdocs\u002Fzh-CN\u002Fskills\u002Frust-testing\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: rust-testing\ndescription: Rust测试模式，包括单元测试、集成测试、异步测试、基于属性的测试、模拟和覆盖率。遵循TDD方法学。\norigin: ECC\n---\n\n# Rust 测试模式\n\n遵循 TDD 方法论编写可靠、可维护测试的全面 Rust 测试模式。\n\n## 何时使用\n\n* 编写新的 Rust 函数、方法或特征\n* 为现有代码添加测试覆盖率\n* 为性能关键代码创建基准测试\n* 为输入验证实现基于属性的测试\n* 在 Rust 项目中遵循 TDD 工作流\n\n## 工作原理\n\n1. **识别目标代码** — 找到要测试的函数、特征或模块\n2. **编写测试** — 在 `#[cfg(test)]` 模块中使用 `#[test]`，使用 rstest 进行参数化测试，或使用 proptest 进行基于属性的测试\n3. **模拟依赖项** — 使用 mockall 来隔离被测单元\n4. **运行测试 (RED)** — 验证测试是否按预期失败\n5. **实现 (GREEN)** — 编写最少代码以通过测试\n6. **重构** — 改进代码同时保持测试通过\n7. **检查覆盖率** — 使用 cargo-llvm-cov，目标 80% 以上\n\n## Rust 的 TDD 工作流\n\n### RED-GREEN-REFACTOR 循环\n\n```\nRED     → 先写一个失败的测试\nGREEN   → 编写最少代码使测试通过\nREFACTOR → 重构代码，同时保持测试通过\nREPEAT  → 继续下一个需求\n```\n\n### Rust 中的分步 TDD\n\n```rust\n\u002F\u002F RED: Write test first, use todo!() as placeholder\npub fn add(a: i32, b: i32) -> i32 { todo!() }\n\n#[cfg(test)]\nmod tests {\n    use super::*;\n    #[test]\n    fn test_add() { assert_eq!(add(2, 3), 5); }\n}\n\u002F\u002F cargo test → panics at 'not yet implemented'\n```\n\n```rust\n\u002F\u002F GREEN: Replace todo!() with minimal implementation\npub fn add(a: i32, b: i32) -> i32 { a + b }\n\u002F\u002F cargo test → PASS, then REFACTOR while keeping tests green\n```\n\n## 单元测试\n\n### 模块级测试组织\n\n```rust\n\u002F\u002F src\u002Fuser.rs\npub struct User {\n    pub name: String,\n    pub email: String,\n}\n\nimpl User {\n    pub fn new(name: impl Into\u003CString>, email: impl Into\u003CString>) -> Result\u003CSelf, String> {\n        let email = email.into();\n        if !email.contains('@') {\n            return Err(format!(\"invalid email: {email}\"));\n        }\n        Ok(Self { name: name.into(), email })\n    }\n\n    pub fn display_name(&self) -> &str {\n        &self.name\n    }\n}\n\n#[cfg(test)]\nmod tests {\n    use super::*;\n\n    #[test]\n    fn creates_user_with_valid_email() {\n        let user = User::new(\"Alice\", \"alice@example.com\").unwrap();\n        assert_eq!(user.display_name(), \"Alice\");\n        assert_eq!(user.email, \"alice@example.com\");\n    }\n\n    #[test]\n    fn rejects_invalid_email() {\n        let result = User::new(\"Bob\", \"not-an-email\");\n        assert!(result.is_err());\n        assert!(result.unwrap_err().contains(\"invalid email\"));\n    }\n}\n```\n\n### 断言宏\n\n```rust\nassert_eq!(2 + 2, 4);                                    \u002F\u002F Equality\nassert_ne!(2 + 2, 5);                                    \u002F\u002F Inequality\nassert!(vec![1, 2, 3].contains(&2));                     \u002F\u002F Boolean\nassert_eq!(value, 42, \"expected 42 but got {value}\");    \u002F\u002F Custom message\nassert!((0.1_f64 + 0.2 - 0.3).abs() \u003C f64::EPSILON);   \u002F\u002F Float comparison\n```\n\n## 错误与 Panic 测试\n\n### 测试 `Result` 返回值\n\n```rust\n#[test]\nfn parse_returns_error_for_invalid_input() {\n    let result = parse_config(\"}{invalid\");\n    assert!(result.is_err());\n\n    \u002F\u002F Assert specific error variant\n    let err = result.unwrap_err();\n    assert!(matches!(err, ConfigError::ParseError(_)));\n}\n\n#[test]\nfn parse_succeeds_for_valid_input() -> Result\u003C(), Box\u003Cdyn std::error::Error>> {\n    let config = parse_config(r#\"{\"port\": 8080}\"#)?;\n    assert_eq!(config.port, 8080);\n    Ok(()) \u002F\u002F Test fails if any ? returns Err\n}\n```\n\n### 测试 Panic\n\n```rust\n#[test]\n#[should_panic]\nfn panics_on_empty_input() {\n    process(&[]);\n}\n\n#[test]\n#[should_panic(expected = \"index out of bounds\")]\nfn panics_with_specific_message() {\n    let v: Vec\u003Ci32> = vec![];\n    let _ = v[0];\n}\n```\n\n## 集成测试\n\n### 文件结构\n\n```text\nmy_crate\u002F\n├── src\u002F\n│   └── lib.rs\n├── tests\u002F              # 集成测试\n│   ├── api_test.rs     # 每个文件都是一个独立的测试二进制文件\n│   ├── db_test.rs\n│   └── common\u002F         # 共享测试工具\n│       └── mod.rs\n```\n\n### 编写集成测试\n\n```rust\n\u002F\u002F tests\u002Fapi_test.rs\nuse my_crate::{App, Config};\n\n#[test]\nfn full_request_lifecycle() {\n    let config = Config::test_default();\n    let app = App::new(config);\n\n    let response = app.handle_request(\"\u002Fhealth\");\n    assert_eq!(response.status, 200);\n    assert_eq!(response.body, \"OK\");\n}\n```\n\n## 异步测试\n\n### 使用 Tokio\n\n```rust\n#[tokio::test]\nasync fn fetches_data_successfully() {\n    let client = TestClient::new().await;\n    let result = client.get(\"\u002Fdata\").await;\n    assert!(result.is_ok());\n    assert_eq!(result.unwrap().items.len(), 3);\n}\n\n#[tokio::test]\nasync fn handles_timeout() {\n    use std::time::Duration;\n    let result = tokio::time::timeout(\n        Duration::from_millis(100),\n        slow_operation(),\n    ).await;\n\n    assert!(result.is_err(), \"should have timed out\");\n}\n```\n\n## 测试组织模式\n\n### 使用 `rstest` 进行参数化测试\n\n```rust\nuse rstest::{rstest, fixture};\n\n#[rstest]\n#[case(\"hello\", 5)]\n#[case(\"\", 0)]\n#[case(\"rust\", 4)]\nfn test_string_length(#[case] input: &str, #[case] expected: usize) {\n    assert_eq!(input.len(), expected);\n}\n\n\u002F\u002F Fixtures\n#[fixture]\nfn test_db() -> TestDb {\n    TestDb::new_in_memory()\n}\n\n#[rstest]\nfn test_insert(test_db: TestDb) {\n    test_db.insert(\"key\", \"value\");\n    assert_eq!(test_db.get(\"key\"), Some(\"value\".into()));\n}\n```\n\n### 测试辅助函数\n\n```rust\n#[cfg(test)]\nmod tests {\n    use super::*;\n\n    \u002F\u002F\u002F Creates a test user with sensible defaults.\n    fn make_user(name: &str) -> User {\n        User::new(name, &format!(\"{name}@test.com\")).unwrap()\n    }\n\n    #[test]\n    fn user_display() {\n        let user = make_user(\"alice\");\n        assert_eq!(user.display_name(), \"alice\");\n    }\n}\n```\n\n## 使用 `proptest` 进行基于属性的测试\n\n### 基本属性测试\n\n```rust\nuse proptest::prelude::*;\n\nproptest! {\n    #[test]\n    fn encode_decode_roundtrip(input in \".*\") {\n        let encoded = encode(&input);\n        let decoded = decode(&encoded).unwrap();\n        assert_eq!(input, decoded);\n    }\n\n    #[test]\n    fn sort_preserves_length(mut vec in prop::collection::vec(any::\u003Ci32>(), 0..100)) {\n        let original_len = vec.len();\n        vec.sort();\n        assert_eq!(vec.len(), original_len);\n    }\n\n    #[test]\n    fn sort_produces_ordered_output(mut vec in prop::collection::vec(any::\u003Ci32>(), 0..100)) {\n        vec.sort();\n        for window in vec.windows(2) {\n            assert!(window[0] \u003C= window[1]);\n        }\n    }\n}\n```\n\n### 自定义策略\n\n```rust\nuse proptest::prelude::*;\n\nfn valid_email() -> impl Strategy\u003CValue = String> {\n    (\"[a-z]{1,10}\", \"[a-z]{1,5}\")\n        .prop_map(|(user, domain)| format!(\"{user}@{domain}.com\"))\n}\n\nproptest! {\n    #[test]\n    fn accepts_valid_emails(email in valid_email()) {\n        assert!(User::new(\"Test\", &email).is_ok());\n    }\n}\n```\n\n## 使用 `mockall` 进行模拟\n\n### 基于特征的模拟\n\n```rust\nuse mockall::{automock, predicate::eq};\n\n#[automock]\ntrait UserRepository {\n    fn find_by_id(&self, id: u64) -> Option\u003CUser>;\n    fn save(&self, user: &User) -> Result\u003C(), StorageError>;\n}\n\n#[test]\nfn service_returns_user_when_found() {\n    let mut mock = MockUserRepository::new();\n    mock.expect_find_by_id()\n        .with(eq(42))\n        .times(1)\n        .returning(|_| Some(User { id: 42, name: \"Alice\".into() }));\n\n    let service = UserService::new(Box::new(mock));\n    let user = service.get_user(42).unwrap();\n    assert_eq!(user.name, \"Alice\");\n}\n\n#[test]\nfn service_returns_none_when_not_found() {\n    let mut mock = MockUserRepository::new();\n    mock.expect_find_by_id()\n        .returning(|_| None);\n\n    let service = UserService::new(Box::new(mock));\n    assert!(service.get_user(99).is_none());\n}\n```\n\n## 文档测试\n\n### 可执行的文档\n\n````rust\n\u002F\u002F\u002F Adds two numbers together.\n\u002F\u002F\u002F\n\u002F\u002F\u002F # Examples\n\u002F\u002F\u002F\n\u002F\u002F\u002F ```\n\u002F\u002F\u002F use my_crate::add;\n\u002F\u002F\u002F\n\u002F\u002F\u002F assert_eq!(add(2, 3), 5);\n\u002F\u002F\u002F assert_eq!(add(-1, 1), 0);\n\u002F\u002F\u002F ```\npub fn add(a: i32, b: i32) -> i32 {\n    a + b\n}\n\n\u002F\u002F\u002F Parses a config string.\n\u002F\u002F\u002F\n\u002F\u002F\u002F # Errors\n\u002F\u002F\u002F\n\u002F\u002F\u002F Returns `Err` if the input is not valid TOML.\n\u002F\u002F\u002F\n\u002F\u002F\u002F ```no_run\n\u002F\u002F\u002F use my_crate::parse_config;\n\u002F\u002F\u002F\n\u002F\u002F\u002F let config = parse_config(r#\"port = 8080\"#).unwrap();\n\u002F\u002F\u002F assert_eq!(config.port, 8080);\n\u002F\u002F\u002F ```\n\u002F\u002F\u002F\n\u002F\u002F\u002F ```no_run\n\u002F\u002F\u002F use my_crate::parse_config;\n\u002F\u002F\u002F\n\u002F\u002F\u002F assert!(parse_config(\"}{invalid\").is_err());\n\u002F\u002F\u002F ```\npub fn parse_config(input: &str) -> Result\u003CConfig, ParseError> {\n    todo!()\n}\n````\n\n## 使用 Criterion 进行基准测试\n\n```toml\n# Cargo.toml\n[dev-dependencies]\ncriterion = { version = \"0.5\", features = [\"html_reports\"] }\n\n[[bench]]\nname = \"benchmark\"\nharness = false\n```\n\n```rust\n\u002F\u002F benches\u002Fbenchmark.rs\nuse criterion::{black_box, criterion_group, criterion_main, Criterion};\n\nfn fibonacci(n: u64) -> u64 {\n    match n {\n        0 | 1 => n,\n        _ => fibonacci(n - 1) + fibonacci(n - 2),\n    }\n}\n\nfn bench_fibonacci(c: &mut Criterion) {\n    c.bench_function(\"fib 20\", |b| b.iter(|| fibonacci(black_box(20))));\n}\n\ncriterion_group!(benches, bench_fibonacci);\ncriterion_main!(benches);\n```\n\n## 测试覆盖率\n\n### 运行覆盖率\n\n```bash\n# Install: cargo install cargo-llvm-cov (or use taiki-e\u002Finstall-action in CI)\ncargo llvm-cov                    # Summary\ncargo llvm-cov --html             # HTML report\ncargo llvm-cov --lcov > lcov.info # LCOV format for CI\ncargo llvm-cov --fail-under-lines 80  # Fail if below threshold\n```\n\n### 覆盖率目标\n\n| 代码类型 | 目标 |\n|-----------|--------|\n| 关键业务逻辑 | 100% |\n| 公共 API | 90%+ |\n| 通用代码 | 80%+ |\n| 生成的 \u002F FFI 绑定 | 排除 |\n\n## 测试命令\n\n```bash\ncargo test                        # Run all tests\ncargo test -- --nocapture         # Show println output\ncargo test test_name              # Run tests matching pattern\ncargo test --lib                  # Unit tests only\ncargo test --test api_test        # Integration tests only\ncargo test --doc                  # Doc tests only\ncargo test --no-fail-fast         # Don't stop on first failure\ncargo test -- --ignored           # Run ignored tests\n```\n\n## 最佳实践\n\n**应该做：**\n\n* 先写测试 (TDD)\n* 使用 `#[cfg(test)]` 模块进行单元测试\n* 测试行为，而非实现\n* 使用描述性测试名称来解释场景\n* 为了更好的错误信息，优先使用 `assert_eq!` 而非 `assert!`\n* 在返回 `Result` 的测试中使用 `?` 以获得更清晰的错误输出\n* 保持测试独立 — 没有共享的可变状态\n\n**不应该做：**\n\n* 在可以测试 `Result::is_err()` 时使用 `#[should_panic]`\n* 模拟所有内容 — 在可行时优先考虑集成测试\n* 忽略不稳定的测试 — 修复或隔离它们\n* 在测试中使用 `sleep()` — 使用通道、屏障或 `tokio::time::pause()`\n* 跳过错误路径测试\n\n## CI 集成\n\n```yaml\n# GitHub Actions\ntest:\n  runs-on: ubuntu-latest\n  steps:\n    - uses: actions\u002Fcheckout@v4\n    - uses: dtolnay\u002Frust-toolchain@stable\n      with:\n        components: clippy, rustfmt\n\n    - name: Check formatting\n      run: cargo fmt --check\n\n    - name: Clippy\n      run: cargo clippy -- -D warnings\n\n    - name: Run tests\n      run: cargo test\n\n    - uses: taiki-e\u002Finstall-action@cargo-llvm-cov\n\n    - name: Coverage\n      run: cargo llvm-cov --fail-under-lines 80\n```\n\n**记住**：测试就是文档。它们展示了你的代码应如何使用。清晰编写并保持更新。\n","# Rust 测试模式\n\n遵循 TDD 方法论编写可靠、可维护测试的全面 Rust 测试模式。\n\n## 何时使用\n\n* 编写新的 Rust 函数、方法或特征\n* 为现有代码添加测试覆盖率\n* 为性能关键代码创建基准测试\n* 为输入验证实现基于属性的测试\n* 在 Rust 项目中遵循 TDD 工作流\n\n## 工作原理\n\n1. **识别目标代码** — 找到要测试的函数、特征或模块\n2. **编写测试** — 在 `#[cfg(test)]` 模块中使用 `#[test]`，使用 rstest 进行参数化测试，或使用 proptest 进行基于属性的测试\n3. **模拟依赖项** — 使用 mockall 来隔离被测单元\n4. **运行测试 (RED)** — 验证测试是否按预期失败\n5. **实现 (GREEN)** — 编写最少代码以通过测试\n6. **重构** — 改进代码同时保持测试通过\n7. **检查覆盖率** — 使用 cargo-llvm-cov，目标 80% 以上\n\n## Rust 的 TDD 工作流\n\n### RED-GREEN-REFACTOR 循环\n\n```\nRED     → 先写一个失败的测试\nGREEN   → 编写最少代码使测试通过\nREFACTOR → 重构代码，同时保持测试通过\nREPEAT  → 继续下一个需求\n```\n\n### Rust 中的分步 TDD\n\n```rust\n\u002F\u002F RED: Write test first, use todo!() as placeholder\npub fn add(a: i32, b: i32) -> i32 { todo!() }\n\n#[cfg(test)]\nmod tests {\n    use super::*;\n    #[test]\n    fn test_add() { assert_eq!(add(2, 3), 5); }\n}\n\u002F\u002F cargo test → panics at 'not yet implemented'\n```\n\n```rust\n\u002F\u002F GREEN: Replace todo!() with minimal implementation\npub fn add(a: i32, b: i32) -> i32 { a + b }\n\u002F\u002F cargo test → PASS, then REFACTOR while keeping tests green\n```\n\n## 单元测试\n\n### 模块级测试组织\n\n```rust\n\u002F\u002F src\u002Fuser.rs\npub struct User {\n    pub name: String,\n    pub email: String,\n}\n\nimpl User {\n    pub fn new(name: impl Into\u003CString>, email: impl Into\u003CString>) -> Result\u003CSelf, String> {\n        let email = email.into();\n        if !email.contains('@') {\n            return Err(format!(\"invalid email: {email}\"));\n        }\n        Ok(Self { name: name.into(), email })\n    }\n\n    pub fn display_name(&self) -> &str {\n        &self.name\n    }\n}\n\n#[cfg(test)]\nmod tests {\n    use super::*;\n\n    #[test]\n    fn creates_user_with_valid_email() {\n        let user = User::new(\"Alice\", \"alice@example.com\").unwrap();\n        assert_eq!(user.display_name(), \"Alice\");\n        assert_eq!(user.email, \"alice@example.com\");\n    }\n\n    #[test]\n    fn rejects_invalid_email() {\n        let result = User::new(\"Bob\", \"not-an-email\");\n        assert!(result.is_err());\n        assert!(result.unwrap_err().contains(\"invalid email\"));\n    }\n}\n```\n\n### 断言宏\n\n```rust\nassert_eq!(2 + 2, 4);                                    \u002F\u002F Equality\nassert_ne!(2 + 2, 5);                                    \u002F\u002F Inequality\nassert!(vec![1, 2, 3].contains(&2));                     \u002F\u002F Boolean\nassert_eq!(value, 42, \"expected 42 but got {value}\");    \u002F\u002F Custom message\nassert!((0.1_f64 + 0.2 - 0.3).abs() \u003C f64::EPSILON);   \u002F\u002F Float comparison\n```\n\n## 错误与 Panic 测试\n\n### 测试 `Result` 返回值\n\n```rust\n#[test]\nfn parse_returns_error_for_invalid_input() {\n    let result = parse_config(\"}{invalid\");\n    assert!(result.is_err());\n\n    \u002F\u002F Assert specific error variant\n    let err = result.unwrap_err();\n    assert!(matches!(err, ConfigError::ParseError(_)));\n}\n\n#[test]\nfn parse_succeeds_for_valid_input() -> Result\u003C(), Box\u003Cdyn std::error::Error>> {\n    let config = parse_config(r#\"{\"port\": 8080}\"#)?;\n    assert_eq!(config.port, 8080);\n    Ok(()) \u002F\u002F Test fails if any ? returns Err\n}\n```\n\n### 测试 Panic\n\n```rust\n#[test]\n#[should_panic]\nfn panics_on_empty_input() {\n    process(&[]);\n}\n\n#[test]\n#[should_panic(expected = \"index out of bounds\")]\nfn panics_with_specific_message() {\n    let v: Vec\u003Ci32> = vec![];\n    let _ = v[0];\n}\n```\n\n## 集成测试\n\n### 文件结构\n\n```text\nmy_crate\u002F\n├── src\u002F\n│   └── lib.rs\n├── tests\u002F              # 集成测试\n│   ├── api_test.rs     # 每个文件都是一个独立的测试二进制文件\n│   ├── db_test.rs\n│   └── common\u002F         # 共享测试工具\n│       └── mod.rs\n```\n\n### 编写集成测试\n\n```rust\n\u002F\u002F tests\u002Fapi_test.rs\nuse my_crate::{App, Config};\n\n#[test]\nfn full_request_lifecycle() {\n    let config = Config::test_default();\n    let app = App::new(config);\n\n    let response = app.handle_request(\"\u002Fhealth\");\n    assert_eq!(response.status, 200);\n    assert_eq!(response.body, \"OK\");\n}\n```\n\n## 异步测试\n\n### 使用 Tokio\n\n```rust\n#[tokio::test]\nasync fn fetches_data_successfully() {\n    let client = TestClient::new().await;\n    let result = client.get(\"\u002Fdata\").await;\n    assert!(result.is_ok());\n    assert_eq!(result.unwrap().items.len(), 3);\n}\n\n#[tokio::test]\nasync fn handles_timeout() {\n    use std::time::Duration;\n    let result = tokio::time::timeout(\n        Duration::from_millis(100),\n        slow_operation(),\n    ).await;\n\n    assert!(result.is_err(), \"should have timed out\");\n}\n```\n\n## 测试组织模式\n\n### 使用 `rstest` 进行参数化测试\n\n```rust\nuse rstest::{rstest, fixture};\n\n#[rstest]\n#[case(\"hello\", 5)]\n#[case(\"\", 0)]\n#[case(\"rust\", 4)]\nfn test_string_length(#[case] input: &str, #[case] expected: usize) {\n    assert_eq!(input.len(), expected);\n}\n\n\u002F\u002F Fixtures\n#[fixture]\nfn test_db() -> TestDb {\n    TestDb::new_in_memory()\n}\n\n#[rstest]\nfn test_insert(test_db: TestDb) {\n    test_db.insert(\"key\", \"value\");\n    assert_eq!(test_db.get(\"key\"), Some(\"value\".into()));\n}\n```\n\n### 测试辅助函数\n\n```rust\n#[cfg(test)]\nmod tests {\n    use super::*;\n\n    \u002F\u002F\u002F Creates a test user with sensible defaults.\n    fn make_user(name: &str) -> User {\n        User::new(name, &format!(\"{name}@test.com\")).unwrap()\n    }\n\n    #[test]\n    fn user_display() {\n        let user = make_user(\"alice\");\n        assert_eq!(user.display_name(), \"alice\");\n    }\n}\n```\n\n## 使用 `proptest` 进行基于属性的测试\n\n### 基本属性测试\n\n```rust\nuse proptest::prelude::*;\n\nproptest! {\n    #[test]\n    fn encode_decode_roundtrip(input in \".*\") {\n        let encoded = encode(&input);\n        let decoded = decode(&encoded).unwrap();\n        assert_eq!(input, decoded);\n    }\n\n    #[test]\n    fn sort_preserves_length(mut vec in prop::collection::vec(any::\u003Ci32>(), 0..100)) {\n        let original_len = vec.len();\n        vec.sort();\n        assert_eq!(vec.len(), original_len);\n    }\n\n    #[test]\n    fn sort_produces_ordered_output(mut vec in prop::collection::vec(any::\u003Ci32>(), 0..100)) {\n        vec.sort();\n        for window in vec.windows(2) {\n            assert!(window[0] \u003C= window[1]);\n        }\n    }\n}\n```\n\n### 自定义策略\n\n```rust\nuse proptest::prelude::*;\n\nfn valid_email() -> impl Strategy\u003CValue = String> {\n    (\"[a-z]{1,10}\", \"[a-z]{1,5}\")\n        .prop_map(|(user, domain)| format!(\"{user}@{domain}.com\"))\n}\n\nproptest! {\n    #[test]\n    fn accepts_valid_emails(email in valid_email()) {\n        assert!(User::new(\"Test\", &email).is_ok());\n    }\n}\n```\n\n## 使用 `mockall` 进行模拟\n\n### 基于特征的模拟\n\n```rust\nuse mockall::{automock, predicate::eq};\n\n#[automock]\ntrait UserRepository {\n    fn find_by_id(&self, id: u64) -> Option\u003CUser>;\n    fn save(&self, user: &User) -> Result\u003C(), StorageError>;\n}\n\n#[test]\nfn service_returns_user_when_found() {\n    let mut mock = MockUserRepository::new();\n    mock.expect_find_by_id()\n        .with(eq(42))\n        .times(1)\n        .returning(|_| Some(User { id: 42, name: \"Alice\".into() }));\n\n    let service = UserService::new(Box::new(mock));\n    let user = service.get_user(42).unwrap();\n    assert_eq!(user.name, \"Alice\");\n}\n\n#[test]\nfn service_returns_none_when_not_found() {\n    let mut mock = MockUserRepository::new();\n    mock.expect_find_by_id()\n        .returning(|_| None);\n\n    let service = UserService::new(Box::new(mock));\n    assert!(service.get_user(99).is_none());\n}\n```\n\n## 文档测试\n\n### 可执行的文档\n\n````rust\n\u002F\u002F\u002F Adds two numbers together.\n\u002F\u002F\u002F\n\u002F\u002F\u002F # Examples\n\u002F\u002F\u002F\n\u002F\u002F\u002F ```\n\u002F\u002F\u002F use my_crate::add;\n\u002F\u002F\u002F\n\u002F\u002F\u002F assert_eq!(add(2, 3), 5);\n\u002F\u002F\u002F assert_eq!(add(-1, 1), 0);\n\u002F\u002F\u002F ```\npub fn add(a: i32, b: i32) -> i32 {\n    a + b\n}\n\n\u002F\u002F\u002F Parses a config string.\n\u002F\u002F\u002F\n\u002F\u002F\u002F # Errors\n\u002F\u002F\u002F\n\u002F\u002F\u002F Returns `Err` if the input is not valid TOML.\n\u002F\u002F\u002F\n\u002F\u002F\u002F ```no_run\n\u002F\u002F\u002F use my_crate::parse_config;\n\u002F\u002F\u002F\n\u002F\u002F\u002F let config = parse_config(r#\"port = 8080\"#).unwrap();\n\u002F\u002F\u002F assert_eq!(config.port, 8080);\n\u002F\u002F\u002F ```\n\u002F\u002F\u002F\n\u002F\u002F\u002F ```no_run\n\u002F\u002F\u002F use my_crate::parse_config;\n\u002F\u002F\u002F\n\u002F\u002F\u002F assert!(parse_config(\"}{invalid\").is_err());\n\u002F\u002F\u002F ```\npub fn parse_config(input: &str) -> Result\u003CConfig, ParseError> {\n    todo!()\n}\n````\n\n## 使用 Criterion 进行基准测试\n\n```toml\n# Cargo.toml\n[dev-dependencies]\ncriterion = { version = \"0.5\", features = [\"html_reports\"] }\n\n[[bench]]\nname = \"benchmark\"\nharness = false\n```\n\n```rust\n\u002F\u002F benches\u002Fbenchmark.rs\nuse criterion::{black_box, criterion_group, criterion_main, Criterion};\n\nfn fibonacci(n: u64) -> u64 {\n    match n {\n        0 | 1 => n,\n        _ => fibonacci(n - 1) + fibonacci(n - 2),\n    }\n}\n\nfn bench_fibonacci(c: &mut Criterion) {\n    c.bench_function(\"fib 20\", |b| b.iter(|| fibonacci(black_box(20))));\n}\n\ncriterion_group!(benches, bench_fibonacci);\ncriterion_main!(benches);\n```\n\n## 测试覆盖率\n\n### 运行覆盖率\n\n```bash\n# Install: cargo install cargo-llvm-cov (or use taiki-e\u002Finstall-action in CI)\ncargo llvm-cov                    # Summary\ncargo llvm-cov --html             # HTML report\ncargo llvm-cov --lcov > lcov.info # LCOV format for CI\ncargo llvm-cov --fail-under-lines 80  # Fail if below threshold\n```\n\n### 覆盖率目标\n\n| 代码类型 | 目标 |\n|-----------|--------|\n| 关键业务逻辑 | 100% |\n| 公共 API | 90%+ |\n| 通用代码 | 80%+ |\n| 生成的 \u002F FFI 绑定 | 排除 |\n\n## 测试命令\n\n```bash\ncargo test                        # Run all tests\ncargo test -- --nocapture         # Show println output\ncargo test test_name              # Run tests matching pattern\ncargo test --lib                  # Unit tests only\ncargo test --test api_test        # Integration tests only\ncargo test --doc                  # Doc tests only\ncargo test --no-fail-fast         # Don't stop on first failure\ncargo test -- --ignored           # Run ignored tests\n```\n\n## 最佳实践\n\n**应该做：**\n\n* 先写测试 (TDD)\n* 使用 `#[cfg(test)]` 模块进行单元测试\n* 测试行为，而非实现\n* 使用描述性测试名称来解释场景\n* 为了更好的错误信息，优先使用 `assert_eq!` 而非 `assert!`\n* 在返回 `Result` 的测试中使用 `?` 以获得更清晰的错误输出\n* 保持测试独立 — 没有共享的可变状态\n\n**不应该做：**\n\n* 在可以测试 `Result::is_err()` 时使用 `#[should_panic]`\n* 模拟所有内容 — 在可行时优先考虑集成测试\n* 忽略不稳定的测试 — 修复或隔离它们\n* 在测试中使用 `sleep()` — 使用通道、屏障或 `tokio::time::pause()`\n* 跳过错误路径测试\n\n## CI 集成\n\n```yaml\n# GitHub Actions\ntest:\n  runs-on: ubuntu-latest\n  steps:\n    - uses: actions\u002Fcheckout@v4\n    - uses: dtolnay\u002Frust-toolchain@stable\n      with:\n        components: clippy, rustfmt\n\n    - name: Check formatting\n      run: cargo fmt --check\n\n    - name: Clippy\n      run: cargo clippy -- -D warnings\n\n    - name: Run tests\n      run: cargo test\n\n    - uses: taiki-e\u002Finstall-action@cargo-llvm-cov\n\n    - name: Coverage\n      run: cargo llvm-cov --fail-under-lines 80\n```\n\n**记住**：测试就是文档。它们展示了你的代码应如何使用。清晰编写并保持更新。\n",{"name":5,"origin":24,"description":7},"ECC","main","87afe6ce96220accf50a345dea46784c8c9f210e","YYC3-AI-应用工具\u002FYYC3-AI-应用工具-Everything-claude-code\u002Fdocs\u002Fzh-CN\u002Fskills\u002Frust-testing",0,"https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base","https:\u002F\u002Fkb.yyc3.top\u002F","https:\u002F\u002Fgithub.com\u002FYYC-Cube","万象归元于云枢 | 深栈智启新纪元","2026-11-10 10:37:32",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add YYC-Cube\u002FYYC3-Knowledge-Base --skill rust-testing",{"tool":40,"command":41},"bunx","bunx skills add YYC-Cube\u002FYYC3-Knowledge-Base --skill rust-testing",{"tool":43,"command":44},"pnpm","pnpm dlx skills add YYC-Cube\u002FYYC3-Knowledge-Base --skill rust-testing","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-AI-应用工具\u002FYYC3-AI-应用工具-Everything-claude-code\u002Fdocs\u002Fzh-CN\u002Fskills\u002Frust-testing\u002FSKILL.md",true,[],[49,56,63,70,77,84],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":19},"01M7CTDWHERCXPQCP0K03A86AS","vercel-sandbox","Run agent-browser + Chrome inside Vercel Sandbox microVMs for browser automation from any Vercel-deployed app. Use when the user needs browser automation in a Vercel app (Next.js, SvelteKit, Nuxt, Remix, Astro, etc.), wants to run headless Chrome without binary size limits, needs persistent browser sessions across commands, or wants ephemeral isolated browser environments. Triggers include \"Vercel Sandbox browser\", \"microVM Chrome\", \"agent-browser in sandbox\", \"browser automation on Vercel\", or any task requiring Chrome in a Vercel Sandbox.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Fvercel-sandbox\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":19},"01M7CTD8D2BNJY54S65M47HEJA","slack","Interact with Slack workspaces using browser automation. Use when the user needs to check unread channels, navigate Slack, send messages, extract data, find information, search conversations, or automate any Slack task. Triggers include \"check my Slack\", \"what channels have unreads\", \"send a message to\", \"search Slack for\", \"extract from Slack\", \"find who said\", or any task requiring programmatic Slack interaction.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Fslack\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":19},"01M7CTCSSB8ZP3Q58C3YZDZK1W","electron","Automate Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify, etc.) using agent-browser via Chrome DevTools Protocol. Use when the user needs to interact with an Electron app, automate a desktop app, connect to a running app, control a native app, or test an Electron application. Triggers include \"automate Slack app\", \"control VS Code\", \"interact with Discord app\", \"test this Electron app\", \"connect to desktop app\", or any task requiring automation of a native Electron application.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Felectron\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M7CTCBJY76688V4DCZGWFHGQ","dogfood","Systematically explore and test a web application to find bugs, UX issues, and other problems. Use when asked to \"dogfood\", \"QA\", \"exploratory test\", \"find issues\", \"bug hunt\", \"test this app\u002Fsite\u002Fplatform\", or review the quality of a web application. Produces a structured report with full reproduction evidence -- step-by-step screenshots, repro videos, and detailed repro steps for every issue -- so findings can be handed directly to the responsible teams.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Fdogfood\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M7CTC4H0FFGVEAQR9PA4GA1A","agent-browser","Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to \"open a website\", \"fill out a form\", \"click a button\", \"take a screenshot\", \"scrape data from a page\", \"test this web app\", \"login to a site\", \"automate browser actions\", or any task requiring programmatic web interaction.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Fagent-browser\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M7CTBKVFYBG78FDSABSDJTTQ","shadcn","Manages shadcn components and projects — adding, searching, fixing, debugging, styling, and composing UI, including chat interfaces. Provides project context, component docs, and usage examples. Applies when working with shadcn\u002Fui, component registries, presets, --preset codes, or any project with a components.json file. Also triggers for \"shadcn init\", \"create an app with --preset\", \"switch to --preset\", and for building a design system or applying a DESIGN.md or brand spec to shadcn\u002Fui.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-UI-界面组件\u002FYYC3-UI-界面组件-ui\u002Fskills\u002Fshadcn\u002FSKILL.md",[],[]]