Rust CLI开发指南：领域约束、clap参数解析与最佳实践

domain-cli by zhanghandong/rust-skills

534 周安装量

920 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/zhanghandong/rust-skills --skill domain-cli

开发自动化 Rust

🇨🇳中文介绍

CLI 领域

第 3 层：领域约束

领域约束 → 设计影响

领域规则	设计约束	Rust 实现含义
用户人体工程学	清晰的帮助和错误信息	clap 派生宏
配置优先级	CLI > 环境变量 > 文件	分层配置加载
退出码	出错时返回非零值	正确处理 Result
标准输出/标准错误输出	数据 vs 错误	使用 eprintln! 输出错误
可中断性	处理 Ctrl+C	信号处理

关键约束

用户通信

RULE: Errors to stderr, data to stdout
WHY: Pipeable output, scriptability
RUST: eprintln! for errors, println! for data

广告位招租

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

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

联系我们

相关 Skills

FlyClaw：零登录航班聚合查询工具，Python实现多源航班信息与价格搜索

4,000,000 周安装

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

749,400 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

255,700 周安装

Vercel Web界面规范检查工具 - 自动检测代码是否符合Web设计指南

205,600 周安装

"Need argument parsing"
    ↓ m05-type-driven: Derive structs for args
    ↓ clap: #[derive(Parser)]

"Need config layering"
    ↓ m09-domain: Config as domain object
    ↓ figment/config: Layer sources

"Need progress display"
    ↓ m12-lifecycle: Progress bar as RAII
    ↓ indicatif: ProgressBar

用途	库
参数解析	clap
交互式提示	dialoguer
进度条	indicatif
彩色输出	colored
终端用户界面	ratatui
终端控制	crossterm
控制台工具	console

模式	目的	实现
参数结构体	类型安全的参数	`#[derive(Parser)]`
子命令	命令层次结构	`#[derive(Subcommand)]`
配置层	覆盖优先级	CLI > env > file
进度	用户反馈	`ProgressBar::new(len)`

use clap::{Parser, Subcommand};

#[derive(Parser)]
#[command(name = "myapp", about = "My CLI tool")]
struct Cli {
    /// Enable verbose output
    #[arg(short, long)]
    verbose: bool,

    #[command(subcommand)]
    command: Commands,
}

#[derive(Subcommand)]
enum Commands {
    /// Initialize a new project
    Init { name: String },
    /// Run the application
    Run {
        #[arg(short, long)]
        port: Option<u16>,
    },
}

fn main() -> anyhow::Result<()> {
    let cli = Cli::parse();
    match cli.command {
        Commands::Init { name } => init_project(&name)?,
        Commands::Run { port } => run_server(port.unwrap_or(8080))?,
    }
    Ok(())
}

错误	违反的领域规则	修复方法
错误输出到 stdout	破坏管道操作	eprintln!
没有帮助文本	用户体验差	#[arg(help = "...")]
出错时 panic	退出码不正确	Result + 正确处理
长时间操作无进度显示	用户不确定	indicatif

约束	第 2 层模式	第 1 层实现
类型安全的参数	派生宏	clap Parser
错误处理	Result 传播	anyhow + 退出码
用户反馈	进度 RAII	indicatif ProgressBar
配置优先级	构建器模式	分层源

何时需要	参见
错误处理	m06-error-handling
类型驱动参数	m05-type-driven
进度生命周期	m12-lifecycle
异步 CLI	m07-concurrency

🇺🇸English

CLI Domain

Layer 3: Domain Constraints

Domain Constraints → Design Implications

Domain Rule	Design Constraint	Rust Implication
User ergonomics	Clear help, errors	clap derive macros
Config precedence	CLI > env > file	Layered config loading
Exit codes	Non-zero on error	Proper Result handling
Stdout/stderr	Data vs errors	eprintln! for errors
Interruptible	Handle Ctrl+C	Signal handling

Critical Constraints

User Communication

RULE: Errors to stderr, data to stdout
WHY: Pipeable output, scriptability
RUST: eprintln! for errors, println! for data

Configuration Priority

RULE: CLI args > env vars > config file > defaults
WHY: User expectation, override capability
RUST: Layered config with clap + figment/config

Exit Codes

RULE: Return non-zero on any error
WHY: Script integration, automation
RUST: main() -> Result<(), Error> or explicit exit()

Trace Down ↓

From constraints to design (Layer 2):

"Need argument parsing"
    ↓ m05-type-driven: Derive structs for args
    ↓ clap: #[derive(Parser)]

"Need config layering"
    ↓ m09-domain: Config as domain object
    ↓ figment/config: Layer sources

"Need progress display"
    ↓ m12-lifecycle: Progress bar as RAII
    ↓ indicatif: ProgressBar

Key Crates

Purpose	Crate
Argument parsing	clap
Interactive prompts	dialoguer
Progress bars	indicatif
Colored output	colored
Terminal UI	ratatui
Terminal control	crossterm
Console utilities	console

Design Patterns

Pattern	Purpose	Implementation
Args struct	Type-safe args	`#[derive(Parser)]`
Subcommands	Command hierarchy	`#[derive(Subcommand)]`
Config layers	Override precedence	CLI > env > file
Progress	User feedback	`ProgressBar::new(len)`

Code Pattern: CLI Structure

use clap::{Parser, Subcommand};

#[derive(Parser)]
#[command(name = "myapp", about = "My CLI tool")]
struct Cli {
    /// Enable verbose output
    #[arg(short, long)]
    verbose: bool,

    #[command(subcommand)]
    command: Commands,
}

#[derive(Subcommand)]
enum Commands {
    /// Initialize a new project
    Init { name: String },
    /// Run the application
    Run {
        #[arg(short, long)]
        port: Option<u16>,
    },
}

fn main() -> anyhow::Result<()> {
    let cli = Cli::parse();
    match cli.command {
        Commands::Init { name } => init_project(&name)?,
        Commands::Run { port } => run_server(port.unwrap_or(8080))?,
    }
    Ok(())
}

Common Mistakes

Mistake	Domain Violation	Fix
Errors to stdout	Breaks piping	eprintln!
No help text	Poor UX	#[arg(help = "...")]
Panic on error	Bad exit code	Result + proper handling
No progress for long ops	User uncertainty	indicatif

Trace to Layer 1

Constraint	Layer 2 Pattern	Layer 1 Implementation
Type-safe args	Derive macros	clap Parser
Error handling	Result propagation	anyhow + exit codes
User feedback	Progress RAII	indicatif ProgressBar
Config precedence	Builder pattern	Layered sources

Related Skills

When	See
Error handling	m06-error-handling
Type-driven args	m05-type-driven
Progress lifecycle	m12-lifecycle
Async CLI	m07-concurrency

Weekly Installs

534

Repository

zhanghandong/rust-skills

GitHub Stars

920

First Seen

Jan 20, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

opencode487

codex473

gemini-cli466

github-copilot451

amp409

kimi-cli403