第7章属性 on 编程那些事儿

01-测试

Tue, 18 Aug 2026 08:45:00 +0800

译文 · 基于 The Rust Reference

原文链接: https://doc.rust-lang.org/reference/attributes/testing.html

r[attributes.testing]

测试

下列属性用于指定执行测试的函数。以“test”模式编译 crate 时，会一并构建测试函数以及用于执行测试的测试框架。启用测试模式同时也会启用 test 条件编译选项。

r[attributes.testing.test]

`test` 属性

r[attributes.testing.test.intro] *test 属性*将函数标记为作为测试执行。

[i18n] example

1
2
3
4
5
6


# pub fn add(left: u64, right: u64) -> u64 { left + right }
#[test]
fn it_works() {
 let result = add(2, 2);
 assert_eq!(result, 4);
}

r[attributes.testing.test.syntax] test 属性使用 [MetaWord] 语法。

02-Derive

Tue, 18 Aug 2026 08:45:00 +0800

译文 · 基于 The Rust Reference

原文链接: https://doc.rust-lang.org/reference/attributes/derive.html

r[attributes.derive]

Derive

r[attributes.derive.intro] *derive [属性][attributes]*会调用一个或多个 derive 宏，从而为数据结构自动生成新的项。你可以通过过程宏创建 derive 宏。

[i18n] example

[PartialEq][macro@PartialEq] derive 宏会为 Foo<T> where T: PartialEq 生成 [PartialEq] 的实现。[Clone][macro@Clone] derive 宏对 [Clone] 同理。

03-诊断

Tue, 18 Aug 2026 08:45:00 +0800

译文 · 基于 The Rust Reference

原文链接: https://doc.rust-lang.org/reference/attributes/diagnostics.html

r[attributes.diagnostics]

诊断

下列属性用于在编译期间控制或生成诊断消息。

r[attributes.diagnostics.lint]

Lint 检查属性

Lint 检查会为可能不受欢迎的编码模式命名，例如不可达代码或缺失文档。

r[attributes.diagnostics.lint.level] Lint 属性 allow、expect、warn、deny 和 forbid 使用 [MetaListPaths] 语法，指定一组 lint 名称，以更改该属性所应用实体的 lint 级别。

04-代码生成

Tue, 18 Aug 2026 08:45:00 +0800

译文 · 基于 The Rust Reference

原文链接: https://doc.rust-lang.org/reference/attributes/codegen.html

r[attributes.codegen]

代码生成

下列属性用于控制代码生成。

r[attributes.codegen.inline]

`inline` 属性

r[attributes.codegen.inline.intro] *inline 属性*建议是否将被标注函数的代码副本放入调用者中，而不是生成对该函数的调用。

[i18n] example

1
2
3
4
5
6
7
8


#[inline]
pub fn example1() {}

#[inline(always)]
pub fn example2() {}

#[inline(never)]
pub fn example3() {}

注意 rustc 在认为值得时会自动内联函数。请谨慎使用此属性，因为关于内联哪些函数的不当决策会拖慢程序。

05-限制

Tue, 18 Aug 2026 08:45:00 +0800

译文 · 基于 The Rust Reference

原文链接: https://doc.rust-lang.org/reference/attributes/limits.html

r[attributes.limits]

限制

下列属性影响编译期限制。

r[attributes.limits.recursion_limit]

`recursion_limit` 属性

r[attributes.limits.recursion_limit.intro] recursion_limit 属性可应用于 crate 级别，以设置可能无限递归的编译期操作（如宏展开或自动解引用）的最大深度。

r[attributes.limits.recursion_limit.syntax] 它使用 [MetaNameValueStr] 语法来指定递归深度。

06-类型系统

Tue, 18 Aug 2026 08:45:00 +0800

译文 · 基于 The Rust Reference

原文链接: https://doc.rust-lang.org/reference/attributes/type_system.html

r[attributes.type-system]

类型系统

下列属性用于改变类型的使用方式。

r[attributes.type-system.non_exhaustive]

`non_exhaustive` 属性

r[attributes.type-system.non_exhaustive.intro] non_exhaustive 属性表示某类型或变体将来可能添加更多字段或变体。

r[attributes.type-system.non_exhaustive.allowed-positions] 它可应用于 struct、enum 以及 enum 变体。

r[attributes.type-system.non_exhaustive.syntax] non_exhaustive 属性使用 [MetaWord] 语法，因此不接受任何输入。

07-调试器

Tue, 18 Aug 2026 08:45:00 +0800

译文 · 基于 The Rust Reference

原文链接: https://doc.rust-lang.org/reference/attributes/debugger.html

r[attributes.debugger]

调试器

下列属性用于在使用 GDB 或 WinDbg 等第三方调试器时增强调试体验。

r[attributes.debugger.debugger_visualizer]

`debugger_visualizer` 属性

r[attributes.debugger.debugger_visualizer.intro] *debugger_visualizer 属性*可将调试器可视化文件嵌入到调试信息中。这会改善显示值时的调试体验。

[i18n] example

1
2


#![debugger_visualizer(natvis_file = "Example.natvis")]
#![debugger_visualizer(gdb_script_file = "example.py")]

r[attributes.debugger.debugger_visualizer.syntax] debugger_visualizer 属性使用 [MetaListNameValueStr] 语法指定其输入。必须指定下列键之一：

第7章 属性 on 编程那些事儿

01-测试

测试

test 属性

02-Derive

Derive

03-诊断

诊断

Lint 检查属性

04-代码生成

代码生成

inline 属性

05-限制

限制

recursion_limit 属性

06-类型系统

类型系统

non_exhaustive 属性

07-调试器

调试器

debugger_visualizer 属性

第7章属性 on 编程那些事儿

`test` 属性

`inline` 属性

`recursion_limit` 属性

`non_exhaustive` 属性

`debugger_visualizer` 属性