技能 systems-programming-rust-project
📦

systems-programming-rust-project

安全

使用cargo搭建生产级Rust项目

构建Rust应用程序需要正确的项目结构和配置。此技能可生成完整的、符合Rust习惯的项目脚手架,包含cargo工具、模块组织、测试设置和最佳实践。

支持: Claude Codex Code(CC)
🥉 74 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“systems-programming-rust-project”。 创建带CLI参数的二进制项目

预期结果:

生成的项目结构包含Cargo.toml、src/main.rs(带clap Parser)、src/cli.rs(带命令定义)、src/commands/模块、使用anyhow的错误处理和集成测试设置。

正在使用“systems-programming-rust-project”。 为Web应用程序设置工作空间

预期结果:

创建的工作空间包含crates/api(Axum Web服务)、crates/core(共享类型和逻辑)、crates/cli(管理工具)、工作空间Cargo.toml中的共享依赖和集成测试。

安全审计

安全
v1 • 2/25/2026

This skill is documentation-only instructional content for Rust project scaffolding. Static analyzer flagged 41 patterns (35 external_commands, 1 network, 5 blocker) but all are false positives from markdown code blocks and template examples. No executable code or actual security risks present.

1
已扫描文件
443
分析行数
0
发现项
1
审计总数
未发现安全问题
审计者: claude

质量评分

38
架构
100
可维护性
87
内容
50
社区
100
安全
91
规范符合性

你能构建什么

CLI工具开发

快速搭建新的命令行工具,包含参数解析、错误处理和使用clap和anyhow的适当模块结构。

Rust库创建

生成可重用的crate,包含文档示例、集成测试和最少的依赖,以便发布到crates.io。

Web服务设置

创建包含Axum路由、中间件、使用SQLx的数据库集成和全面错误处理的Web API项目。

试试这些提示

基础二进制项目
创建一个名为'my-cli-tool'的新Rust二进制项目,使用clap进行CLI解析,使用tokio作为异步运行时。
带测试的库
生成一个Rust库项目,包含单元测试、集成测试和文档示例。包含适当的错误类型。
多crate工作空间
设置一个包含三个crate的Rust工作空间:core(库)、api(Web服务)和cli(命令行界面)。在工作空间级别共享依赖。
带数据库的完整Web API
使用Axum和SQLx for PostgreSQL搭建生产级Web API,包含用户路由、认证中间件和健康检查端点。

最佳实践

  • 使用2021版并设置rust-version以保证兼容性
  • 按功能将代码组织到模块中,清晰分离关注点
  • 在源文件中包含单元测试,在单独目录中包含集成测试

避免

  • 避免添加不必要的依赖 - 保持库最小化
  • 不要在生产代码中使用unwrap() - 使用Result进行适当的错误处理
  • 避免 monolithic main.rs - 尽早拆分为逻辑模块

常见问题

我应该使用哪个Rust版本?
使用Rust 2021版(当前稳定版)并将rust-version设置为1.75或更高,以获得现代功能和长期支持。
库是否应该提交Cargo.lock?
不应该,库不应该提交Cargo.lock。应用程序和二进制文件应该提交它以确保可重现构建。
如何向项目添加基准测试?
添加criterion作为dev-dependency,创建benches/目录,并在Cargo.toml中配置[[bench]],设置harness = false。
什么是Rust工作空间?
工作空间允许多个crate共享单个Cargo.lock和构建输出。将其用于相互依赖的多crate项目。
如何配置clippy进行严格 lint 检查?
运行'cargo clippy -- -D warnings'来拒绝所有警告。创建clippy.toml来自定义阈值,如cognitive-complexity-threshold。
在Rust中构建Web API应该使用什么框架?
Axum推荐用于新项目 - 它人体工程学设计良好、维护良好,构建在tokio和tower之上。Actix-web对于性能关键型应用也很受欢迎。