{"id":82538,"date":"2026-07-25T10:10:20","date_gmt":"2026-07-25T02:10:20","guid":{"rendered":"https:\/\/www.wsisp.com\/helps\/82538.html"},"modified":"2026-07-25T10:10:20","modified_gmt":"2026-07-25T02:10:20","slug":"%e7%b3%bb%e7%bb%9f%e7%ba%a7%e5%b7%a5%e5%85%b7%e9%93%be%e5%bc%80%e5%8f%91%ef%bc%9acargo-%e5%b7%a5%e4%bd%9c%e5%8c%ba%e7%ae%a1%e7%90%86%ef%bc%8c%e4%bb%8e%e5%8d%95-crate-%e5%88%b0%e5%a4%9a%e6%a8%a1","status":"publish","type":"post","link":"https:\/\/www.wsisp.com\/helps\/82538.html","title":{"rendered":"\u7cfb\u7edf\u7ea7\u5de5\u5177\u94fe\u5f00\u53d1\uff1aCargo \u5de5\u4f5c\u533a\u7ba1\u7406\uff0c\u4ece\u5355 crate \u5230\u591a\u6a21\u5757\u5de5\u7a0b\u6f14\u8fdb"},"content":{"rendered":"

\u7cfb\u7edf\u7ea7\u5de5\u5177\u94fe\u5f00\u53d1：Cargo \u5de5\u4f5c\u533a\u7ba1\u7406，\u4ece\u5355 crate \u5230\u591a\u6a21\u5757\u5de5\u7a0b\u6f14\u8fdb<\/h2>\n

\"cover\"<\/p>\n

\u4e00\u3001\u5355 crate \u7684\u5929\u82b1\u677f：\u5f53\u4f60\u7684\u5de5\u5177\u94fe\u5f00\u59cb\u81a8\u80c0<\/h3>\n

\u5f88\u591a Rust \u9879\u76ee\u6700\u521d\u90fd\u662f\u4e00\u4e2a\u5355 crate\u3002\u4e00\u4e2a main.rs，\u4e00\u4e2a Cargo.toml，\u7b80\u5355\u76f4\u63a5\u3002\u4f46\u968f\u7740\u529f\u80fd\u589e\u957f，\u95ee\u9898\u5f00\u59cb\u51fa\u73b0：\u7f16\u8bd1\u65f6\u95f4\u8d8a\u6765\u8d8a\u957f，\u4f9d\u8d56\u5173\u7cfb\u8d8a\u6765\u8d8a\u4e71，\u6d4b\u8bd5\u8dd1\u4e00\u6b21\u8981\u7b49\u597d\u51e0\u5206\u949f\u3002<\/p>\n

\u66f4\u81f4\u547d\u7684\u662f，\u5f53\u4f60\u60f3\u628a\u5de5\u5177\u94fe\u4e2d\u7684\u67d0\u4e2a\u6a21\u5757\u62bd\u51fa\u6765\u4f5c\u4e3a\u72ec\u7acb\u5e93\u53d1\u5e03\u65f6，\u53d1\u73b0\u6240\u6709\u4ee3\u7801\u90fd\u8026\u5408\u5728\u4e00\u8d77，\u6839\u672c\u65e0\u6cd5\u62c6\u5206\u3002\u6216\u8005\u4f60\u60f3\u8ba9\u5de5\u5177\u94fe\u7684\u4e0d\u540c\u7ec4\u4ef6\u5171\u4eab\u4e00\u4e9b\u516c\u5171\u903b\u8f91，\u4f46\u5355 crate \u7ed3\u6784\u4e0b\u53ea\u80fd\u9760 mod \u6765\u7ec4\u7ec7，\u53d1\u5e03\u548c\u7248\u672c\u7ba1\u7406\u65e0\u4ece\u8c08\u8d77\u3002<\/p>\n

Cargo \u5de5\u4f5c\u533a（Workspace）\u5c31\u662f\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\u7684\u6807\u51c6\u65b9\u6848\u3002\u5b83\u5141\u8bb8\u4f60\u5c06\u591a\u4e2a crate \u653e\u5728\u540c\u4e00\u4e2a\u4ed3\u5e93\u4e2d\u7ba1\u7406，\u5171\u4eab\u4e00\u4e2a Cargo.lock，\u7edf\u4e00\u4f9d\u8d56\u7248\u672c，\u540c\u65f6\u4fdd\u6301\u5404 crate \u7684\u72ec\u7acb\u7f16\u8bd1\u548c\u53d1\u5e03\u80fd\u529b\u3002<\/p>\n

\u672c\u6587\u5c06\u4ece\u4e00\u4e2a\u5b9e\u9645\u7684\u591a\u6a21\u5757\u5de5\u5177\u94fe\u9879\u76ee\u51fa\u53d1，\u8bb2\u89e3 Cargo \u5de5\u4f5c\u533a\u7684\u7ec4\u7ec7\u65b9\u5f0f\u3001\u4f9d\u8d56\u7ba1\u7406\u7b56\u7565\u548c\u5e38\u89c1\u8e29\u5751\u70b9\u3002<\/p>\n

\u4e8c\u3001Cargo \u5de5\u4f5c\u533a\u7684\u5e95\u5c42\u673a\u5236：\u5171\u4eab\u4e0e\u9694\u79bb\u7684\u5e73\u8861<\/h3>\n

2.1 \u5de5\u4f5c\u533a\u7684\u57fa\u672c\u7ed3\u6784<\/h4>\n

Cargo \u5de5\u4f5c\u533a\u7531\u4e00\u4e2a\u6839 Cargo.toml \u548c\u591a\u4e2a\u6210\u5458 crate \u7ec4\u6210\u3002\u6839 Cargo.toml \u4f7f\u7528 [workspace] \u6bb5\u58f0\u660e\u6210\u5458\u5217\u8868，\u6210\u5458 crate \u5404\u81ea\u6709\u72ec\u7acb\u7684 Cargo.toml\u3002<\/p>\n

flowchart TD
\n A[\u6839 Cargo.toml<br\/>workspace \u5b9a\u4e49] –> B[\u6210\u5458 crate: cli<br\/>\u547d\u4ee4\u884c\u5165\u53e3]
\n A –> C[\u6210\u5458 crate: core<br\/>\u6838\u5fc3\u903b\u8f91\u5e93]
\n A –> D[\u6210\u5458 crate: utils<br\/>\u516c\u5171\u5de5\u5177\u5e93]
\n A –> E[\u6210\u5458 crate: proto<br\/>\u534f\u8bae\u5b9a\u4e49\u5e93]
\n B –> C
\n B –> D
\n C –> D
\n C –> E
\n E –> D
\n F[Cargo.lock<br\/>\u5de5\u4f5c\u533a\u7ea7\u522b\u5171\u4eab] -.-> A<\/p>\n

2.2 \u5171\u4eab Cargo.lock \u7684\u610f\u4e49<\/h4>\n

\u5de5\u4f5c\u533a\u4e2d\u6240\u6709\u6210\u5458\u5171\u4eab\u540c\u4e00\u4e2a Cargo.lock\u3002\u8fd9\u786e\u4fdd\u4e86\u4f9d\u8d56\u7248\u672c\u7684\u4e00\u81f4\u6027\u3002\u5982\u679c cli \u548c core \u90fd\u4f9d\u8d56 serde，\u5b83\u4eec\u4e00\u5b9a\u4f7f\u7528\u540c\u4e00\u4e2a\u7248\u672c，\u4e0d\u4f1a\u51fa\u73b0 cli \u7528 serde 1.0.200 \u800c core \u7528 serde 1.0.180 \u7684\u60c5\u51b5\u3002<\/p>\n

\u8fd9\u4e2a\u673a\u5236\u5728\u5de5\u5177\u94fe\u5f00\u53d1\u4e2d\u7279\u522b\u91cd\u8981\u3002\u5982\u679c\u4f60\u7684 CLI \u5de5\u5177\u548c\u6838\u5fc3\u5e93\u4f7f\u7528\u4e86\u4e0d\u540c\u7248\u672c\u7684\u4f9d\u8d56，\u53ef\u80fd\u5728\u5e8f\u5217\u5316\/\u53cd\u5e8f\u5217\u5316\u65f6\u51fa\u73b0\u5fae\u5999\u7684\u517c\u5bb9\u6027\u95ee\u9898，\u800c\u4e14\u6781\u96be\u6392\u67e5\u3002<\/p>\n

2.3 \u4f9d\u8d56\u4f20\u9012\u4e0e workspace.dependencies<\/h4>\n

Rust 1.64 \u5f15\u5165\u4e86 workspace.dependencies，\u5141\u8bb8\u5728\u6839 Cargo.toml \u4e2d\u7edf\u4e00\u58f0\u660e\u4f9d\u8d56\u7248\u672c，\u6210\u5458 crate \u901a\u8fc7 workspace = true \u5f15\u7528\u3002\u8fd9\u89e3\u51b3\u4e86"\u540c\u4e00\u4e2a\u4f9d\u8d56\u5728\u591a\u4e2a crate \u4e2d\u7248\u672c\u4e0d\u4e00\u81f4"\u7684\u95ee\u9898\u3002<\/p>\n

2.4 \u7f16\u8bd1\u7f13\u5b58\u4e0e\u589e\u91cf\u7f16\u8bd1<\/h4>\n

\u5de5\u4f5c\u533a\u7684\u53e6\u4e00\u4e2a\u4f18\u52bf\u662f\u7f16\u8bd1\u7f13\u5b58\u5171\u4eab\u3002\u5f53\u4f60\u4fee\u6539\u4e86 cli crate \u7684\u4ee3\u7801，\u53ea\u6709 cli \u9700\u8981\u91cd\u65b0\u7f16\u8bd1，core \u548c utils \u7684\u7f16\u8bd1\u4ea7\u7269\u4f1a\u88ab\u7f13\u5b58\u590d\u7528\u3002\u8fd9\u5728\u5927\u578b\u5de5\u5177\u94fe\u4e2d\u80fd\u8282\u7701\u5927\u91cf\u7f16\u8bd1\u65f6\u95f4\u3002<\/p>\n

\u4e09\u3001\u751f\u4ea7\u7ea7\u4ee3\u7801：\u4e00\u4e2a\u591a\u6a21\u5757\u5de5\u5177\u94fe\u7684\u5b8c\u6574\u5de5\u4f5c\u533a<\/h3>\n

3.1 \u5de5\u4f5c\u533a\u6839\u914d\u7f6e<\/h4>\n

# \u6839 Cargo.toml：\u5de5\u4f5c\u533a\u5b9a\u4e49\u4e0e\u7edf\u4e00\u4f9d\u8d56\u7ba1\u7406
\n[workspace]
\nmembers = [
\n "crates\/cli",
\n "crates\/core",
\n "crates\/utils",
\n "crates\/proto",
\n]
\nresolver = "2"<\/p>\n

# \u7edf\u4e00\u4f9d\u8d56\u7248\u672c：\u6240\u6709\u6210\u5458 crate \u5f15\u7528\u540c\u4e00\u7248\u672c
\n[workspace.dependencies]
\nserde = { version = "1", features = ["derive"] }
\nserde_json = "1"
\ntokio = { version = "1", features = ["full"] }
\nanyhow = "1"
\nthiserror = "1"
\ntracing = "0.1"
\ntracing-subscriber = { version = "0.3", features = ["env-filter"] }
\nclap = { version = "4", features = ["derive"] }<\/p>\n

3.2 \u6210\u5458 crate \u914d\u7f6e<\/h4>\n

# crates\/cli\/Cargo.toml：\u547d\u4ee4\u884c\u5165\u53e3
\n[package]
\nname = "my-toolchain-cli"
\nversion = "0.1.0"
\nedition = "2021"<\/p>\n

[dependencies]
\nmy-toolchain-core = { path = "..\/core" }
\nmy-toolchain-utils = { path = "..\/utils" }
\nserde = { workspace = true }
\nserde_json = { workspace = true }
\ntokio = { workspace = true }
\nanyhow = { workspace = true }
\nclap = { workspace = true }
\ntracing = { workspace = true }
\ntracing-subscriber = { workspace = true }<\/p>\n

# crates\/core\/Cargo.toml：\u6838\u5fc3\u903b\u8f91\u5e93
\n[package]
\nname = "my-toolchain-core"
\nversion = "0.1.0"
\nedition = "2021"<\/p>\n

[dependencies]
\nmy-toolchain-utils = { path = "..\/utils" }
\nmy-toolchain-proto = { path = "..\/proto" }
\nserde = { workspace = true }
\nanyhow = { workspace = true }
\nthiserror = { workspace = true }
\ntokio = { workspace = true }
\ntracing = { workspace = true }<\/p>\n

3.3 \u516c\u5171\u5de5\u5177\u5e93：\u6d88\u9664\u91cd\u590d\u4ee3\u7801<\/h4>\n

\/\/ crates\/utils\/src\/lib.rs：\u516c\u5171\u5de5\u5177\u51fd\u6570
\npub mod logging;
\npub mod config;
\npub mod error;<\/p>\n

\/\/\/ \u521d\u59cb\u5316\u65e5\u5fd7\u7cfb\u7edf：\u7edf\u4e00\u6240\u6709 crate \u7684\u65e5\u5fd7\u683c\u5f0f
\npub fn init_logging(level: &str) {
\n use tracing_subscriber::{fmt, EnvFilter};
\n let filter = EnvFilter::try_from_default_env()
\n .unwrap_or_else(|_| EnvFilter::new(level));
\n fmt().with_env_filter(filter).init();
\n}<\/p>\n

\/\/\/ \u914d\u7f6e\u6587\u4ef6\u8def\u5f84\u89e3\u6790：\u652f\u6301 XDG \u6807\u51c6\u548c\u81ea\u5b9a\u4e49\u8def\u5f84
\npub fn resolve_config_path(custom: Option<&str>) -> std::path::PathBuf {
\n if let Some(path) = custom {
\n return std::path::PathBuf::from(path);
\n }
\n \/\/ \u4f18\u5148\u4f7f\u7528 XDG_CONFIG_HOME
\n if let Ok(xdg) = std::env::var("XDG_CONFIG_HOME") {
\n return std::path::PathBuf::from(xdg).join("my-toolchain");
\n }
\n \/\/ \u56de\u9000\u5230 ~\/.config
\n let home = std::env::var("HOME").unwrap_or_else(|_| ".".to_string());
\n std::path::PathBuf::from(home)
\n .join(".config")
\n .join("my-toolchain")
\n}<\/p>\n

3.4 \u6838\u5fc3\u5e93：\u4e1a\u52a1\u903b\u8f91\u4e0e\u9519\u8bef\u5904\u7406<\/h4>\n

\/\/ crates\/core\/src\/lib.rs：\u6838\u5fc3\u4e1a\u52a1\u903b\u8f91
\npub mod analyzer;
\npub mod pipeline;<\/p>\n

use my_toolchain_utils::error::AppError;<\/p>\n

\/\/\/ \u5206\u6790\u7ed3\u679c：\u6838\u5fc3\u6570\u636e\u7ed3\u6784，\u4f9b CLI \u548c\u5176\u4ed6\u6d88\u8d39\u8005\u4f7f\u7528
\n#[derive(Debug, serde::Serialize, serde::Deserialize)]
\npub struct AnalysisResult {
\n pub name: String,
\n pub score: f64,
\n pub details: Vec<String>,
\n}<\/p>\n

\/\/\/ \u6267\u884c\u5206\u6790\u6d41\u6c34\u7ebf：\u4e32\u8054\u591a\u4e2a\u5206\u6790\u6b65\u9aa4
\npub async fn run_analysis(
\n input: &str,
\n config: &AnalysisConfig,
\n) -> Result<Vec<AnalysisResult>, AppError> {
\n let raw_data = load_input(input).await?;
\n let processed = preprocess(raw_data, config).await?;
\n let results = analyze(processed, config).await?;
\n Ok(results)
\n}<\/p>\n

\/\/\/ \u5206\u6790\u914d\u7f6e：\u63a7\u5236\u5206\u6790\u884c\u4e3a\u7684\u53c2\u6570
\n#[derive(Debug, Clone)]
\npub struct AnalysisConfig {
\n pub max_depth: usize,
\n pub timeout_secs: u64,
\n pub verbose: bool,
\n}<\/p>\n

async fn load_input(path: &str) -> Result<String, AppError> {
\n tokio::fs::read_to_string(path)
\n .await
\n .map_err(|e| AppError::Io(e.to_string()))
\n}<\/p>\n

async fn preprocess(data: String, config: &AnalysisConfig) -> Result<String, AppError> {
\n \/\/ \u5b9e\u9645\u5b9e\u73b0\u4e2d\u5305\u542b\u6570\u636e\u6e05\u6d17\u3001\u683c\u5f0f\u8f6c\u6362\u7b49\u6b65\u9aa4
\n Ok(data)
\n}<\/p>\n

async fn analyze(data: String, config: &AnalysisConfig) -> Result<Vec<AnalysisResult>, AppError> {
\n \/\/ \u5b9e\u9645\u5b9e\u73b0\u4e2d\u5305\u542b\u6838\u5fc3\u5206\u6790\u903b\u8f91
\n Ok(vec![])
\n}<\/p>\n

3.5 CLI \u5165\u53e3：\u7ec4\u88c5\u5404\u6a21\u5757<\/h4>\n

\/\/ crates\/cli\/src\/main.rs：\u547d\u4ee4\u884c\u5165\u53e3
\nuse clap::Parser;
\nuse my_toolchain_core::{self, AnalysisConfig};
\nuse my_toolchain_utils;<\/p>\n

#[derive(Parser, Debug)]
\n#[command(name = "my-toolchain", about = "\u7cfb\u7edf\u7ea7\u5de5\u5177\u94fe")]
\nstruct Cli {
\n \/\/\/ \u8f93\u5165\u6587\u4ef6\u8def\u5f84
\n #[arg(short, long)]
\n input: String,<\/p>\n

\/\/\/ \u6700\u5927\u5206\u6790\u6df1\u5ea6
\n #[arg(long, default_value_t = 10)]
\n max_depth: usize,<\/p>\n

\/\/\/ \u8d85\u65f6\u65f6\u95f4（\u79d2）
\n #[arg(long, default_value_t = 30)]
\n timeout: u64,<\/p>\n

\/\/\/ \u8be6\u7ec6\u8f93\u51fa
\n #[arg(short, long)]
\n verbose: bool,<\/p>\n

\/\/\/ \u914d\u7f6e\u6587\u4ef6\u8def\u5f84
\n #[arg(long)]
\n config: Option<String>,
\n}<\/p>\n

#[tokio::main]
\nasync fn main() -> anyhow::Result<()> {
\n let cli = Cli::parse();<\/p>\n

\/\/ \u521d\u59cb\u5316\u65e5\u5fd7
\n let log_level = if cli.verbose { "debug" } else { "info" };
\n my_toolchain_utils::init_logging(log_level);<\/p>\n

\/\/ \u89e3\u6790\u914d\u7f6e
\n let config_path = my_toolchain_utils::resolve_config_path(cli.config.as_deref());
\n let config = AnalysisConfig {
\n max_depth: cli.max_depth,
\n timeout_secs: cli.timeout,
\n verbose: cli.verbose,
\n };<\/p>\n

\/\/ \u6267\u884c\u5206\u6790
\n let results = my_toolchain_core::run_analysis(&cli.input, &config).await?;<\/p>\n

\/\/ \u8f93\u51fa\u7ed3\u679c
\n let json = serde_json::to_string_pretty(&results)?;
\n println!("{}", json);<\/p>\n

Ok(())
\n}<\/p>\n

\u56db\u3001\u5de5\u4f5c\u533a\u7684\u4ee3\u4ef7：\u590d\u6742\u5ea6\u3001\u7f16\u8bd1\u65f6\u95f4\u4e0e\u4f9d\u8d56\u5730\u72f1<\/h3>\n

4.1 \u5faa\u73af\u4f9d\u8d56\u7684\u9677\u9631<\/h4>\n

\u5de5\u4f5c\u533a\u4e2d\u6700\u5e38\u89c1\u7684\u95ee\u9898\u662f\u5faa\u73af\u4f9d\u8d56：crate A \u4f9d\u8d56 crate B，crate B \u53c8\u4f9d\u8d56 crate A\u3002Cargo \u4e0d\u5141\u8bb8\u5faa\u73af\u4f9d\u8d56，\u4f1a\u76f4\u63a5\u62a5\u9519\u3002<\/p>\n

\u89e3\u51b3\u65b9\u6848：\u5c06\u5171\u4eab\u903b\u8f91\u63d0\u53d6\u5230\u7b2c\u4e09\u4e2a crate \u4e2d\u3002\u5982\u679c A \u548c B \u90fd\u9700\u8981\u67d0\u6bb5\u903b\u8f91，\u628a\u5b83\u653e\u5230 utils crate \u4e2d，\u8ba9 A \u548c B \u90fd\u4f9d\u8d56 utils\u3002<\/p>\n

4.2 \u7f16\u8bd1\u65f6\u95f4\u7684\u6743\u8861<\/h4>\n

\u5de5\u4f5c\u533a\u867d\u7136\u652f\u6301\u589e\u91cf\u7f16\u8bd1，\u4f46\u9996\u6b21\u7f16\u8bd1\u4ecd\u7136\u9700\u8981\u7f16\u8bd1\u6240\u6709\u4f9d\u8d56\u3002\u5982\u679c\u67d0\u4e2a\u6210\u5458 crate \u5f15\u5165\u4e86\u91cd\u578b\u4f9d\u8d56（\u5982 diesel\u3001aws-sdk），\u5373\u4f7f\u4f60\u53ea\u4fee\u6539\u4e86 cli crate，\u9996\u6b21\u7f16\u8bd1\u65f6\u4e5f\u4f1a\u62c9\u53d6\u5e76\u7f16\u8bd1\u8fd9\u4e9b\u91cd\u578b\u4f9d\u8d56\u3002<\/p>\n

\u5efa\u8bae：\u5c06\u91cd\u578b\u4f9d\u8d56\u9650\u5236\u5728\u771f\u6b63\u9700\u8981\u7684 crate \u4e2d，\u907f\u514d\u5728 utils \u7b49\u516c\u5171 crate \u4e2d\u5f15\u5165\u3002<\/p>\n

4.3 \u7248\u672c\u53d1\u5e03\u7684\u534f\u8c03<\/h4>\n

\u5de5\u4f5c\u533a\u4e2d\u7684 crate \u5982\u679c\u9700\u8981\u72ec\u7acb\u53d1\u5e03\u5230 crates.io，\u7248\u672c\u53f7\u7ba1\u7406\u662f\u4e00\u4e2a\u6311\u6218\u3002core \u53d1\u5e03\u4e86 0.2.0，\u4f46 cli \u8fd8\u5728\u7528 0.1.0 \u7684 core，\u7528\u6237\u53ef\u80fd\u4f1a\u9047\u5230\u517c\u5bb9\u6027\u95ee\u9898\u3002<\/p>\n

\u5efa\u8bae：\u4f7f\u7528 cargo release \u5de5\u5177\u7edf\u4e00\u7ba1\u7406\u7248\u672c\u53d1\u5e03，\u6216\u8005\u5728\u5de5\u4f5c\u533a\u5185\u90e8\u59cb\u7ec8\u4f7f\u7528 path \u4f9d\u8d56，\u53ea\u5728\u53d1\u5e03\u65f6\u5207\u6362\u5230\u7248\u672c\u4f9d\u8d56\u3002<\/p>\n

4.4 \u4e0d\u9002\u5408\u5de5\u4f5c\u533a\u7684\u573a\u666f<\/h4>\n

\u4ee5\u4e0b\u573a\u666f\u4e0d\u5efa\u8bae\u4f7f\u7528\u5de5\u4f5c\u533a：<\/p>\n