comprehensive-rust 控制流基础Rust 宏Macros的实战应用与标准库宏详解【免费下载链接】comprehensive-rustThis is the Rust course used by the Android team at Google. It provides you the material to quickly teach Rust.项目地址: https://gitcode.com/GitHub_Trending/co/comprehensive-rustRust 宏Macros是 Rust 语言中一类特殊的语法构件它们会在编译期被展开为普通 Rust 代码因此可以接受可变数量的参数并以结尾的!符号与普通函数调用区分开来。本文基于 Google Android 团队维护的 Rust 课程 comprehensive-rust 中的 Control Flow Basics → Macros 一节展开系统讲解标准库中最常用的println!、format!、dbg!、todo!等宏的用法、输出行为与典型应用场景并结合本仓库源码补充测试、断言、循环与 panic 之间的关联实践帮助读者在真实项目中熟练运用这些语法糖。宏的本质编译期展开与!标识在 Rust 中宏macro与函数function最直观的区别就是调用时末尾的感叹号例如println!(hello)。这个!也是语言层面的硬性区分函数参数个数与类型在签名中固定必须在编译期已知宏可以在编译期接收可变数量的参数并在编译阶段被展开expand成一段完整的 Rust 代码随后这段代码再参与类型检查与编译。展开发生在编译期意味着宏不仅不产生运行时额外开销还能做到函数难以实现的事情——例如println!的格式化参数个数完全由格式字符串决定vec![1, 2, 3]可以接受任意多个元素。作为教学重点本节并不要求学员掌握宏的定义机制只需理解这些常用宏的存在本身以及如何正确调用它们。课程中关于如何定义宏并不展开但在后续章节中会介绍derive宏派生宏的使用例如为自定义类型自动实现Debug、Clone等 trait。标准库四大常用宏逐一详解Rust 标准库内置了大量实用宏本节围绕课程重点讲解最常用的四个println!向标准输出打印一行println!(format, ..)println!将格式化的文本输出到标准输出stdout并自动在行尾追加换行符。其格式化语法由标准库的std::fmt模块定义支持的占位符包括占位符形式含义示例{}按Displaytrait 格式化人类可读println!({}, 42){:?}按Debugtrait 格式化调试输出println!({:?}, vec![1,2]){n}按位置引用第 n 个参数println!({1} and {0}, a, b){name}按名称引用命名参数println!({x} {y}, x 1, y 2){n}/{expr}捕获作用域内的变量Rust 1.58println!({n})课程示例中正是使用了{n}捕获语法直接打印变量nfn main() { let n 4; println!({n}! {}, factorial(n)); }这里{n}直接捕获局部变量n值为 4{}则按顺序取第一个位置参数factorial(n)的Display输出最终打印4! 24。format!把格式化结果作为字符串返回format!(format, ..)format!与println!的格式化规则完全一致区别仅在于输出去向println!把结果写到标准输出而format!返回一个String供程序继续使用。它是拼接字符串最安全、最符合 Rust 惯用法的方式典型用法如let message format!(The value is {value}, value 42); let filename format!(backup-{ts}.zip, ts 1700000000);与拼接或to_string()相比format!天然支持任意数量与类型的参数不会发生隐式类型转换错误。dbg!打印表达式值并原样返回dbg!(expression)dbg!是调试利器行为包含三个要点打印向标准错误输出stderr打印表达式所在的文件、行号、表达式源码以及求值结果同时输出Debug格式返回值把表达式求值后的值原样返回因此可以直接内联在表达式中使用不改变原有计算逻辑所有权如果传入的是表达式而非变量则返回该值若传入变量返回的借用/所有权规则与直接传递该变量一致。课程示例将其嵌入阶乘计算的循环中fn factorial(n: u32) - u32 { let mut product 1; for i in 1..n { product * dbg!(i); } product }for i in 1..n是包含端点的范围循环1..n含 n普通1..n不含 n详见 for 循环章节。循环体内dbg!(i)既打印每次迭代的i值又把i原样返回参与product * i的乘法做到一行代码同时完成调试观测与业务计算。运行后 stderr 会输出类似[src/main.rs:5] i 1 [src/main.rs:5] i 2 ...todo!标记未实现代码执行即 panictodo!()todo!()用于显式标记此处代码尚未实现。如果程序执行到该位置会触发 panic详见本仓库的 Panics 章节。panic 会展开unwind调用栈并释放栈上的值通常意味着程序因致命错误而终止。因此todo!()是开发阶段的占位工具用于在编写整体骨架时留出待填函数体让尚未实现的分支在运行时快速暴露而不是静默返回错误结果在编译阶段保证函数签名完整、代码可编译。课程示例中fizzbuzz就是一个未完成的占位实现fn fizzbuzz(n: u32) - u32 { todo!() }由于main只调用了factorial这段代码可以正常编译运行一旦某处调用fizzbuzz程序就会在运行到todo!()时 panic。这也是 panic 语义的重要体现panic 是程序中 bug 的症状而todo!()则是开发者主动埋下的、尚未修复的 bug 标记。完整代码示例factorial 与 fizzbuzz以下是本仓库 macros.md 中的完整示例代码rust,editable标记表示可直接在课程页面的编辑器/Playground 中运行修改fn factorial(n: u32) - u32 { let mut product 1; for i in 1..n { product * dbg!(i); } product } fn fizzbuzz(n: u32) - u32 { todo!() } fn main() { let n 4; println!({n}! {}, factorial(n)); }运行结果分析dbg!(i)在循环中依次打印i 1, 2, 3, 4println!输出4! 24todo!()未被调用因此不会触发 panic。读者可以将fizzbuzz的todo!()替换为真实实现例如按 3/5 整除输出对应字符串的逻辑体会先占位、后填充的增量开发流程。更多值得掌握的宏assert! 家族、unreachable! 与 eprintln!课程在 More To Explore 部分推荐了另外三个高频宏用于满足不同场景assert!与相关断言宏assert!系列宏用于给代码添加断言失败时立即 panic。它们是测试代码的基础设施在本仓库的测试相关章节中被大量使用。以 Unit Tests 章节 为例测试通过#[test]属性标记内部用assert_eq!校验期望值#[test] fn test_multiple_words() { assert_eq!(first_word(Hello World), Hello); }同样本仓库 控制流练习的解答代码 也使用assert_eq!验证 Collatz 序列长度计算的正确性#[test] fn test_collatz_length() { assert_eq!(collatz_length(11), 15); }assert!家族常用成员包括宏作用失败行为assert!(expr)断言表达式为真panic 并打印表达式assert_eq!(a, b)断言两值相等需实现PartialEq与Debugpanic 并打印两值assert_ne!(a, b)断言两值不相等panic 并打印两值debug_assert!仅在 debug 构建下生效的断言发布构建中被移除unreachable!标记不可能到达的分支unreachable!()用于标记逻辑上永远不应被执行的代码分支——例如穷尽匹配后的兜底分支。一旦执行到该处说明程序逻辑出现严重错误宏会触发 panic。它是比todo!()语义更强的不可能发生声明适合在防御性编程中暴露逻辑漏洞。eprintln!向标准错误输出eprintln!与println!格式规则相同但输出目标是标准错误流stderr。dbg!同样输出到 stderr。正确区分 stdout 与 stderr 对命令行工具很重要正常结果走 stdout 便于管道重定向诊断与调试信息走 stderr 避免污染数据流。例如dbg!的输出不会混入|管道后的数据处理结果中。宏在课程体系中的位置与关联知识宏是控制流基础Control Flow Basics章节的收尾内容与课程中多个主题相互呼应循环配合for i in 1..n与dbg!的组合示例体现了宏内联在表达式中的灵活性参见 Loops 章节 与 for 循环章节panic 语义todo!()、assert!、unreachable!的失败行为都归结为 panic其栈展开、释放值、进程终止的机制在 Panics 章节 中有完整说明该章节还演示了panic::catch_unwind捕获展开但明确不建议把 panic 当作异常机制使用并指出当Cargo.toml设置panic abort时展开不可捕获测试实践assert!/assert_eq!与#[cfg(test)]、#[test]结合构成单元测试框架见 Unit Tests 章节课程机制本仓库 mdbook-course 工具链 中源文档以minutes元数据标记教学时长本文档标记为 2 分钟并用rust,editable代码块标记可在线编辑运行的示例println!的格式化规则由标准库std::fmt定义dbg!依赖Debugtrait。如何在本地运行验证comprehensive-rust 是标准的 mdBook 项目配置见 book.toml。要本地构建并浏览本文档所在章节安装 mdBook 与 mdbook-course 预处理器构建方式参考仓库根目录 README.md 与 mdbook-course 说明在仓库根目录执行mdbook build或mdbook serve浏览器打开输出页面依次进入Control Flow Basics → Macros即可看到本文内容所有标记为editable的代码块都可直接运行与修改。也可以把上述factorial/fizzbuzz示例复制到本地任意 Cargo 项目或 Rust Playground中直接运行通过观察dbg!的 stderr 输出与println!的 stdout 输出直观感受标准输出 vs 标准错误与宏返回值参与计算这两个核心行为。小结Rust 宏以!结尾在编译期展开可接受可变数量参数是标准库提供便捷能力的主要形式println!输出到 stdoutformat!返回字符串dbg!打印并返回值todo!标记未完成代码、执行即 panic深入项目开发后assert!/assert_eq!测试断言、unreachable!不可能分支与eprintln!stderr 输出同样属于日常高频宏理解这些宏无需掌握宏定义原理课程后续的derive宏章节会进一步展示由宏自动生成代码的威力。【免费下载链接】comprehensive-rustThis is the Rust course used by the Android team at Google. It provides you the material to quickly teach Rust.项目地址: https://gitcode.com/GitHub_Trending/co/comprehensive-rust创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 comprehensive-rust 控制流基础：Rust 宏（Macros）的实战应用与标准库宏详解
comprehensive-rust 控制流基础Rust 宏Macros的实战应用与标准库宏详解【免费下载链接】comprehensive-rustThis is the Rust course used by the Android team at Google. It provides you the material to quickly teach Rust.项目地址: https://gitcode.com/GitHub_Trending/co/comprehensive-rustRust 宏Macros是 Rust 语言中一类特殊的语法构件它们会在编译期被展开为普通 Rust 代码因此可以接受可变数量的参数并以结尾的!符号与普通函数调用区分开来。本文基于 Google Android 团队维护的 Rust 课程 comprehensive-rust 中的 Control Flow Basics → Macros 一节展开系统讲解标准库中最常用的println!、format!、dbg!、todo!等宏的用法、输出行为与典型应用场景并结合本仓库源码补充测试、断言、循环与 panic 之间的关联实践帮助读者在真实项目中熟练运用这些语法糖。宏的本质编译期展开与!标识在 Rust 中宏macro与函数function最直观的区别就是调用时末尾的感叹号例如println!(hello)。这个!也是语言层面的硬性区分函数参数个数与类型在签名中固定必须在编译期已知宏可以在编译期接收可变数量的参数并在编译阶段被展开expand成一段完整的 Rust 代码随后这段代码再参与类型检查与编译。展开发生在编译期意味着宏不仅不产生运行时额外开销还能做到函数难以实现的事情——例如println!的格式化参数个数完全由格式字符串决定vec![1, 2, 3]可以接受任意多个元素。作为教学重点本节并不要求学员掌握宏的定义机制只需理解这些常用宏的存在本身以及如何正确调用它们。课程中关于如何定义宏并不展开但在后续章节中会介绍derive宏派生宏的使用例如为自定义类型自动实现Debug、Clone等 trait。标准库四大常用宏逐一详解Rust 标准库内置了大量实用宏本节围绕课程重点讲解最常用的四个println!向标准输出打印一行println!(format, ..)println!将格式化的文本输出到标准输出stdout并自动在行尾追加换行符。其格式化语法由标准库的std::fmt模块定义支持的占位符包括占位符形式含义示例{}按Displaytrait 格式化人类可读println!({}, 42){:?}按Debugtrait 格式化调试输出println!({:?}, vec![1,2]){n}按位置引用第 n 个参数println!({1} and {0}, a, b){name}按名称引用命名参数println!({x} {y}, x 1, y 2){n}/{expr}捕获作用域内的变量Rust 1.58println!({n})课程示例中正是使用了{n}捕获语法直接打印变量nfn main() { let n 4; println!({n}! {}, factorial(n)); }这里{n}直接捕获局部变量n值为 4{}则按顺序取第一个位置参数factorial(n)的Display输出最终打印4! 24。format!把格式化结果作为字符串返回format!(format, ..)format!与println!的格式化规则完全一致区别仅在于输出去向println!把结果写到标准输出而format!返回一个String供程序继续使用。它是拼接字符串最安全、最符合 Rust 惯用法的方式典型用法如let message format!(The value is {value}, value 42); let filename format!(backup-{ts}.zip, ts 1700000000);与拼接或to_string()相比format!天然支持任意数量与类型的参数不会发生隐式类型转换错误。dbg!打印表达式值并原样返回dbg!(expression)dbg!是调试利器行为包含三个要点打印向标准错误输出stderr打印表达式所在的文件、行号、表达式源码以及求值结果同时输出Debug格式返回值把表达式求值后的值原样返回因此可以直接内联在表达式中使用不改变原有计算逻辑所有权如果传入的是表达式而非变量则返回该值若传入变量返回的借用/所有权规则与直接传递该变量一致。课程示例将其嵌入阶乘计算的循环中fn factorial(n: u32) - u32 { let mut product 1; for i in 1..n { product * dbg!(i); } product }for i in 1..n是包含端点的范围循环1..n含 n普通1..n不含 n详见 for 循环章节。循环体内dbg!(i)既打印每次迭代的i值又把i原样返回参与product * i的乘法做到一行代码同时完成调试观测与业务计算。运行后 stderr 会输出类似[src/main.rs:5] i 1 [src/main.rs:5] i 2 ...todo!标记未实现代码执行即 panictodo!()todo!()用于显式标记此处代码尚未实现。如果程序执行到该位置会触发 panic详见本仓库的 Panics 章节。panic 会展开unwind调用栈并释放栈上的值通常意味着程序因致命错误而终止。因此todo!()是开发阶段的占位工具用于在编写整体骨架时留出待填函数体让尚未实现的分支在运行时快速暴露而不是静默返回错误结果在编译阶段保证函数签名完整、代码可编译。课程示例中fizzbuzz就是一个未完成的占位实现fn fizzbuzz(n: u32) - u32 { todo!() }由于main只调用了factorial这段代码可以正常编译运行一旦某处调用fizzbuzz程序就会在运行到todo!()时 panic。这也是 panic 语义的重要体现panic 是程序中 bug 的症状而todo!()则是开发者主动埋下的、尚未修复的 bug 标记。完整代码示例factorial 与 fizzbuzz以下是本仓库 macros.md 中的完整示例代码rust,editable标记表示可直接在课程页面的编辑器/Playground 中运行修改fn factorial(n: u32) - u32 { let mut product 1; for i in 1..n { product * dbg!(i); } product } fn fizzbuzz(n: u32) - u32 { todo!() } fn main() { let n 4; println!({n}! {}, factorial(n)); }运行结果分析dbg!(i)在循环中依次打印i 1, 2, 3, 4println!输出4! 24todo!()未被调用因此不会触发 panic。读者可以将fizzbuzz的todo!()替换为真实实现例如按 3/5 整除输出对应字符串的逻辑体会先占位、后填充的增量开发流程。更多值得掌握的宏assert! 家族、unreachable! 与 eprintln!课程在 More To Explore 部分推荐了另外三个高频宏用于满足不同场景assert!与相关断言宏assert!系列宏用于给代码添加断言失败时立即 panic。它们是测试代码的基础设施在本仓库的测试相关章节中被大量使用。以 Unit Tests 章节 为例测试通过#[test]属性标记内部用assert_eq!校验期望值#[test] fn test_multiple_words() { assert_eq!(first_word(Hello World), Hello); }同样本仓库 控制流练习的解答代码 也使用assert_eq!验证 Collatz 序列长度计算的正确性#[test] fn test_collatz_length() { assert_eq!(collatz_length(11), 15); }assert!家族常用成员包括宏作用失败行为assert!(expr)断言表达式为真panic 并打印表达式assert_eq!(a, b)断言两值相等需实现PartialEq与Debugpanic 并打印两值assert_ne!(a, b)断言两值不相等panic 并打印两值debug_assert!仅在 debug 构建下生效的断言发布构建中被移除unreachable!标记不可能到达的分支unreachable!()用于标记逻辑上永远不应被执行的代码分支——例如穷尽匹配后的兜底分支。一旦执行到该处说明程序逻辑出现严重错误宏会触发 panic。它是比todo!()语义更强的不可能发生声明适合在防御性编程中暴露逻辑漏洞。eprintln!向标准错误输出eprintln!与println!格式规则相同但输出目标是标准错误流stderr。dbg!同样输出到 stderr。正确区分 stdout 与 stderr 对命令行工具很重要正常结果走 stdout 便于管道重定向诊断与调试信息走 stderr 避免污染数据流。例如dbg!的输出不会混入|管道后的数据处理结果中。宏在课程体系中的位置与关联知识宏是控制流基础Control Flow Basics章节的收尾内容与课程中多个主题相互呼应循环配合for i in 1..n与dbg!的组合示例体现了宏内联在表达式中的灵活性参见 Loops 章节 与 for 循环章节panic 语义todo!()、assert!、unreachable!的失败行为都归结为 panic其栈展开、释放值、进程终止的机制在 Panics 章节 中有完整说明该章节还演示了panic::catch_unwind捕获展开但明确不建议把 panic 当作异常机制使用并指出当Cargo.toml设置panic abort时展开不可捕获测试实践assert!/assert_eq!与#[cfg(test)]、#[test]结合构成单元测试框架见 Unit Tests 章节课程机制本仓库 mdbook-course 工具链 中源文档以minutes元数据标记教学时长本文档标记为 2 分钟并用rust,editable代码块标记可在线编辑运行的示例println!的格式化规则由标准库std::fmt定义dbg!依赖Debugtrait。如何在本地运行验证comprehensive-rust 是标准的 mdBook 项目配置见 book.toml。要本地构建并浏览本文档所在章节安装 mdBook 与 mdbook-course 预处理器构建方式参考仓库根目录 README.md 与 mdbook-course 说明在仓库根目录执行mdbook build或mdbook serve浏览器打开输出页面依次进入Control Flow Basics → Macros即可看到本文内容所有标记为editable的代码块都可直接运行与修改。也可以把上述factorial/fizzbuzz示例复制到本地任意 Cargo 项目或 Rust Playground中直接运行通过观察dbg!的 stderr 输出与println!的 stdout 输出直观感受标准输出 vs 标准错误与宏返回值参与计算这两个核心行为。小结Rust 宏以!结尾在编译期展开可接受可变数量参数是标准库提供便捷能力的主要形式println!输出到 stdoutformat!返回字符串dbg!打印并返回值todo!标记未完成代码、执行即 panic深入项目开发后assert!/assert_eq!测试断言、unreachable!不可能分支与eprintln!stderr 输出同样属于日常高频宏理解这些宏无需掌握宏定义原理课程后续的derive宏章节会进一步展示由宏自动生成代码的威力。【免费下载链接】comprehensive-rustThis is the Rust course used by the Android team at Google. It provides you the material to quickly teach Rust.项目地址: https://gitcode.com/GitHub_Trending/co/comprehensive-rust创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考