本文是对 Rust 项目结构的详细解析，涵盖核心概念、目录布局及最佳实践。<\/p>\n
Cargo.toml<\/code> 文件的目录，用于定义项目元数据（名称、版本、依赖等）。<\/li>\n- 组成<\/strong>：一个 Package 可包含多个 Crate（二进制或库），但最多只能有一个库 Crate（
lib.rs<\/code>）和多个二进制 Crate（main.rs<\/code> 或 src\/bin\/<\/code> 下的文件）。<\/li>\n- 创建方式<\/strong>：\n
\ncargo new project_name<\/code>：创建二进制 Package（默认生成 src\/main.rs<\/code>）。<\/li>\ncargo new --lib project_name<\/code>：创建库 Package（默认生成 src\/lib.rs<\/code>）。<\/li>\n<\/ul>\n<\/li>\n<\/ul>\nCrate（箱）<\/h3>\n\n- 类型<\/strong>：\n
\n- Binary Crate<\/strong>：可执行文件，入口为
src\/main.rs<\/code> 或 src\/bin\/*.rs<\/code>。<\/li>\n- Library Crate<\/strong>：库文件，入口为
src\/lib.rs<\/code>，供其他项目引用。<\/li>\n<\/ul>\n<\/li>\n- 依赖管理<\/strong>：通过
Cargo.toml<\/code> 的 [dependencies]<\/code> 添加外部库，支持本地路径或 crates.io 版本。<\/li>\n<\/ul>\nModule（模块）<\/h3>\n\n- 作用<\/strong>：组织代码的命名空间，通过
mod<\/code> 关键字声明，支持嵌套结构。<\/li>\n- 文件映射<\/strong>：\n
\n- 模块
foo<\/code> 可对应 foo.rs<\/code> 或 foo\/mod.rs<\/code> 文件。<\/li>\n- 通过
pub<\/code> 控制可见性，支持 pub(crate)<\/code>、pub(super)<\/code> 等作用域限定。<\/li>\n<\/ul>\n<\/li>\n- 路径引用<\/strong>：\n
\n- 绝对路径：
crate::module::item<\/code>。<\/li>\n- 相对路径：
self::module::item<\/code> 或 super::module::item<\/code>。<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n目录结构<\/h2>\n标准布局<\/h3>\nmy_project\/\n├── Cargo.toml # 项目配置（依赖、元数据）\n├── Cargo.lock # 依赖版本锁定（自动生成）\n├── src\/\n│ ├── main.rs # 默认二进制入口\n│ ├── lib.rs # 默认库入口\n│ └── bin\/ # 其他二进制入口（每个文件生成独立可执行文件）\n│ └── util.rs\n├── tests\/ # 集成测试\n├── examples\/ # 示例代码\n├── benches\/ # 基准测试\n└── target\/ # 构建输出目录（自动生成）<\/code><\/pre>\n关键目录说明<\/h3>\n\nsrc\/<\/code><\/strong>：核心代码存放位置：\n\nlib.rs<\/code> 定义库的根模块，通过 pub mod<\/code> 导出子模块。<\/li>\nbin\/<\/code> 下每个 .rs<\/code> 文件生成独立二进制文件，可通过 cargo run --bin <name><\/code> 运行。<\/li>\n<\/ul>\n<\/li>\ntests\/<\/code> 和 benches\/<\/code><\/strong>：分别存放集成测试和性能测试，使用 #[test]<\/code> 和 criterion<\/code> 库。<\/li>\nexamples\/<\/code><\/strong>：展示库用法的示例代码，通过 cargo run --example <name><\/code> 运行。<\/li>\n<\/ul>\n模块化与代码组织<\/h2>\n模块树构建<\/h3>\n\n- 隐式根模块<\/strong>：
lib.rs<\/code> 或 main.rs<\/code> 是模块树的根（crate<\/code>），通过 mod<\/code> 引入子模块。<\/li>\n- 示例结构<\/strong>：\n
\/\/ src\/lib.rs\npub mod network { \/\/ 对应 network.rs 或 network\/mod.rs\n pub mod client; \/\/ 对应 network\/client.rs\n}<\/code><\/pre>\n<\/li>\n<\/ul>\n代码拆分最佳实践<\/h3>\n\n- 按功能分层<\/strong>：如将模型、控制器、接口分开放置：\n
src\/\n├── user\/\n│ ├── model.rs\n│ ├── controller.rs\n│ └── api.rs\n└── order\/\n ├── model.rs\n ├── controller.rs\n └── api.rs<\/code><\/pre>\n<\/li>\n- 使用
pub use<\/code> 简化导出<\/strong>：在根模块中重新导出深层模块，减少外部调用路径。<\/li>\n<\/ul>\n高级项目结构<\/h2>\nWorkspace（工作区）<\/h3>\n\n- 用途<\/strong>：管理多个相关 Package（如共享依赖的库和二进制文件）。<\/li>\n
- \n
配置<\/strong>：顶层 Cargo.toml<\/code> 定义 [workspace]<\/code>，指定成员路径：<\/p>\n[workspace]\nmembers = [\"crates\/adder\", \"crates\/add-one\"]<\/code><\/pre>\n<\/li>\n- 优势<\/strong>：共享
target\/<\/code> 和 Cargo.lock<\/code>，减少重复构建。<\/li>\n<\/ul>\n大型项目建议<\/h3>\n\n- 扁平化结构<\/strong>：避免深层嵌套，将 Crate 直接放在
crates\/<\/code> 下（如 rust-analyzer 项目）。<\/li>\n- 独立配置<\/strong>：每个 Crate 的
Cargo.toml<\/code> 可自定义编译选项（如 [lib]<\/code> 或 [[bin]]<\/code>）。<\/li>\n<\/ul>\n工具与命令<\/h2>\n\n- 常用命令<\/strong>：\n
\ncargo new<\/code>：创建项目。<\/li>\ncargo build<\/code>：编译项目（--release<\/code> 优化）。<\/li>\ncargo test<\/code>：运行测试。<\/li>\ncargo doc --open<\/code>：生成并打开文档。<\/li>\n<\/ul>\n<\/li>\n- 依赖管理<\/strong>：在
Cargo.toml<\/code> 中添加 [dependencies]<\/code>，支持语义化版本（如 serde = \"1.0\"<\/code>）。<\/li>\n<\/ul>\n总结<\/h2>\n
Rust 通过 Package → Crate → Module<\/strong> 三级结构实现代码组织，结合 Cargo.toml<\/code> 的灵活配置和标准目录约定，既能支持小型项目快速开发，也能通过 Workspace 和模块化设计管理大型代码库。掌握这些结构后，可结合项目规模选择扁平化或分层设计，提升代码的可维护性和扩展性。<\/p>\n<\/body><\/html>\n","protected":false},"excerpt":{"rendered":"本文是对 Rust 项目&…<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[24],"tags":[],"class_list":["post-410","post","type-post","status-publish","format-standard","hentry","category-programming"],"yoast_head":"\n
Rust \u9879\u76ee\u7ed3\u6784 - \u4f9d\u51e1\u7684 Wordpress<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"http:\/\/blog.yfstudio.online\/?p=410\" \/>\n<meta property=\"og:locale\" content=\"zh_CN\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Rust \u9879\u76ee\u7ed3\u6784 - \u4f9d\u51e1\u7684 Wordpress\" \/>\n<meta property=\"og:description\" content=\"本文是对 Rust 项目&…\" \/>\n<meta property=\"og:url\" content=\"http:\/\/blog.yfstudio.online\/?p=410\" \/>\n<meta property=\"og:site_name\" content=\"\u4f9d\u51e1\u7684 Wordpress\" \/>\n<meta property=\"article:published_time\" content=\"2025-03-30T09:04:25+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-03-30T10:35:26+00:00\" \/>\n<meta name=\"author\" content=\"\u4f9d\u51e1\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"\u4f5c\u8005\" \/>\n\t<meta name=\"twitter:data1\" content=\"\u4f9d\u51e1\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"http:\/\/blog.yfstudio.online\/?p=410#article\",\"isPartOf\":{\"@id\":\"http:\/\/blog.yfstudio.online\/?p=410\"},\"author\":{\"name\":\"\u4f9d\u51e1\",\"@id\":\"http:\/\/blog.yfstudio.online\/#\/schema\/person\/347dc2b9e49d9ab18b527a487874bb08\"},\"headline\":\"Rust \u9879\u76ee\u7ed3\u6784\",\"datePublished\":\"2025-03-30T09:04:25+00:00\",\"dateModified\":\"2025-03-30T10:35:26+00:00\",\"mainEntityOfPage\":{\"@id\":\"http:\/\/blog.yfstudio.online\/?p=410\"},\"wordCount\":29,\"commentCount\":0,\"publisher\":{\"@id\":\"http:\/\/blog.yfstudio.online\/#organization\"},\"articleSection\":[\"\u7f16\u7a0b\"],\"inLanguage\":\"zh-Hans\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"http:\/\/blog.yfstudio.online\/?p=410#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"http:\/\/blog.yfstudio.online\/?p=410\",\"url\":\"http:\/\/blog.yfstudio.online\/?p=410\",\"name\":\"Rust \u9879\u76ee\u7ed3\u6784 - \u4f9d\u51e1\u7684 Wordpress\",\"isPartOf\":{\"@id\":\"http:\/\/blog.yfstudio.online\/#website\"},\"datePublished\":\"2025-03-30T09:04:25+00:00\",\"dateModified\":\"2025-03-30T10:35:26+00:00\",\"breadcrumb\":{\"@id\":\"http:\/\/blog.yfstudio.online\/?p=410#breadcrumb\"},\"inLanguage\":\"zh-Hans\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"http:\/\/blog.yfstudio.online\/?p=410\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"http:\/\/blog.yfstudio.online\/?p=410#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"\u9996\u9875\",\"item\":\"http:\/\/blog.yfstudio.online\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Rust \u9879\u76ee\u7ed3\u6784\"}]},{\"@type\":\"WebSite\",\"@id\":\"http:\/\/blog.yfstudio.online\/#website\",\"url\":\"http:\/\/blog.yfstudio.online\/\",\"name\":\"\u4f9d\u51e1\u7684 Wordpress\",\"description\":\"\",\"publisher\":{\"@id\":\"http:\/\/blog.yfstudio.online\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"http:\/\/blog.yfstudio.online\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"zh-Hans\"},{\"@type\":\"Organization\",\"@id\":\"http:\/\/blog.yfstudio.online\/#organization\",\"name\":\"YFStudio\",\"url\":\"http:\/\/blog.yfstudio.online\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"zh-Hans\",\"@id\":\"http:\/\/blog.yfstudio.online\/#\/schema\/logo\/image\/\",\"url\":\"http:\/\/blog.yfstudio.online\/wp-content\/uploads\/2025\/02\/YF-Studio_logo.png\",\"contentUrl\":\"http:\/\/blog.yfstudio.online\/wp-content\/uploads\/2025\/02\/YF-Studio_logo.png\",\"width\":1600,\"height\":800,\"caption\":\"YFStudio\"},\"image\":{\"@id\":\"http:\/\/blog.yfstudio.online\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/space.bilibili.com\/549933280\"]},{\"@type\":\"Person\",\"@id\":\"http:\/\/blog.yfstudio.online\/#\/schema\/person\/347dc2b9e49d9ab18b527a487874bb08\",\"name\":\"\u4f9d\u51e1\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"zh-Hans\",\"@id\":\"http:\/\/blog.yfstudio.online\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/cravatar.com\/avatar\/2bf3633204b745b9bfe9ec1e86f14422?s=96&d=mm&r=g&cache-key=2bf3633204b745b9bfe9ec1e86f14422\",\"contentUrl\":\"https:\/\/cravatar.com\/avatar\/2bf3633204b745b9bfe9ec1e86f14422?s=96&d=mm&r=g&cache-key=2bf3633204b745b9bfe9ec1e86f14422\",\"caption\":\"\u4f9d\u51e1\"},\"sameAs\":[\"http:\/\/blog.yfstudio.online\"],\"url\":\"http:\/\/blog.yfstudio.online\/?author=1\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Rust \u9879\u76ee\u7ed3\u6784 - \u4f9d\u51e1\u7684 Wordpress","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"http:\/\/blog.yfstudio.online\/?p=410","og_locale":"zh_CN","og_type":"article","og_title":"Rust \u9879\u76ee\u7ed3\u6784 - \u4f9d\u51e1\u7684 Wordpress","og_description":"本文是对 Rust 项目&…","og_url":"http:\/\/blog.yfstudio.online\/?p=410","og_site_name":"\u4f9d\u51e1\u7684 Wordpress","article_published_time":"2025-03-30T09:04:25+00:00","article_modified_time":"2025-03-30T10:35:26+00:00","author":"\u4f9d\u51e1","twitter_card":"summary_large_image","twitter_misc":{"\u4f5c\u8005":"\u4f9d\u51e1"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"http:\/\/blog.yfstudio.online\/?p=410#article","isPartOf":{"@id":"http:\/\/blog.yfstudio.online\/?p=410"},"author":{"name":"\u4f9d\u51e1","@id":"http:\/\/blog.yfstudio.online\/#\/schema\/person\/347dc2b9e49d9ab18b527a487874bb08"},"headline":"Rust \u9879\u76ee\u7ed3\u6784","datePublished":"2025-03-30T09:04:25+00:00","dateModified":"2025-03-30T10:35:26+00:00","mainEntityOfPage":{"@id":"http:\/\/blog.yfstudio.online\/?p=410"},"wordCount":29,"commentCount":0,"publisher":{"@id":"http:\/\/blog.yfstudio.online\/#organization"},"articleSection":["\u7f16\u7a0b"],"inLanguage":"zh-Hans","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["http:\/\/blog.yfstudio.online\/?p=410#respond"]}]},{"@type":"WebPage","@id":"http:\/\/blog.yfstudio.online\/?p=410","url":"http:\/\/blog.yfstudio.online\/?p=410","name":"Rust \u9879\u76ee\u7ed3\u6784 - \u4f9d\u51e1\u7684 Wordpress","isPartOf":{"@id":"http:\/\/blog.yfstudio.online\/#website"},"datePublished":"2025-03-30T09:04:25+00:00","dateModified":"2025-03-30T10:35:26+00:00","breadcrumb":{"@id":"http:\/\/blog.yfstudio.online\/?p=410#breadcrumb"},"inLanguage":"zh-Hans","potentialAction":[{"@type":"ReadAction","target":["http:\/\/blog.yfstudio.online\/?p=410"]}]},{"@type":"BreadcrumbList","@id":"http:\/\/blog.yfstudio.online\/?p=410#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"\u9996\u9875","item":"http:\/\/blog.yfstudio.online\/"},{"@type":"ListItem","position":2,"name":"Rust \u9879\u76ee\u7ed3\u6784"}]},{"@type":"WebSite","@id":"http:\/\/blog.yfstudio.online\/#website","url":"http:\/\/blog.yfstudio.online\/","name":"\u4f9d\u51e1\u7684 Wordpress","description":"","publisher":{"@id":"http:\/\/blog.yfstudio.online\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"http:\/\/blog.yfstudio.online\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"zh-Hans"},{"@type":"Organization","@id":"http:\/\/blog.yfstudio.online\/#organization","name":"YFStudio","url":"http:\/\/blog.yfstudio.online\/","logo":{"@type":"ImageObject","inLanguage":"zh-Hans","@id":"http:\/\/blog.yfstudio.online\/#\/schema\/logo\/image\/","url":"http:\/\/blog.yfstudio.online\/wp-content\/uploads\/2025\/02\/YF-Studio_logo.png","contentUrl":"http:\/\/blog.yfstudio.online\/wp-content\/uploads\/2025\/02\/YF-Studio_logo.png","width":1600,"height":800,"caption":"YFStudio"},"image":{"@id":"http:\/\/blog.yfstudio.online\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/space.bilibili.com\/549933280"]},{"@type":"Person","@id":"http:\/\/blog.yfstudio.online\/#\/schema\/person\/347dc2b9e49d9ab18b527a487874bb08","name":"\u4f9d\u51e1","image":{"@type":"ImageObject","inLanguage":"zh-Hans","@id":"http:\/\/blog.yfstudio.online\/#\/schema\/person\/image\/","url":"https:\/\/cravatar.com\/avatar\/2bf3633204b745b9bfe9ec1e86f14422?s=96&d=mm&r=g&cache-key=2bf3633204b745b9bfe9ec1e86f14422","contentUrl":"https:\/\/cravatar.com\/avatar\/2bf3633204b745b9bfe9ec1e86f14422?s=96&d=mm&r=g&cache-key=2bf3633204b745b9bfe9ec1e86f14422","caption":"\u4f9d\u51e1"},"sameAs":["http:\/\/blog.yfstudio.online"],"url":"http:\/\/blog.yfstudio.online\/?author=1"}]}},"_links":{"self":[{"href":"http:\/\/blog.yfstudio.online\/index.php?rest_route=\/wp\/v2\/posts\/410","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/blog.yfstudio.online\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/blog.yfstudio.online\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/blog.yfstudio.online\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/blog.yfstudio.online\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=410"}],"version-history":[{"count":1,"href":"http:\/\/blog.yfstudio.online\/index.php?rest_route=\/wp\/v2\/posts\/410\/revisions"}],"predecessor-version":[{"id":411,"href":"http:\/\/blog.yfstudio.online\/index.php?rest_route=\/wp\/v2\/posts\/410\/revisions\/411"}],"wp:attachment":[{"href":"http:\/\/blog.yfstudio.online\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=410"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/blog.yfstudio.online\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=410"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/blog.yfstudio.online\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=410"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}