差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 | ||
| rust:属性 [2026/08/13 00:29] – [34.1 什么是属性:先回答"是宏吗"] 张叶安 | rust:属性 [2026/08/17 09:29] (当前版本) – [34.5 `derive`:派生 trait 的生成] 张叶安 | ||
|---|---|---|---|
| 行 25: | 行 25: | ||
| 所以严格地说," | 所以严格地说," | ||
| - | |||
| ## 34.2 内层属性与外层属性 | ## 34.2 内层属性与外层属性 | ||
| 行 31: | 行 30: | ||
| | 写法 | 名称 | 作用对象 | 典型位置 | | | 写法 | 名称 | 作用对象 | 典型位置 | | ||
| - | |------|------|----------|----------| | ||
| | `#[attr]` | 外层属性 | 紧跟在它**后面那一个 item** | 结构体、函数、枚举上方 | | | `#[attr]` | 外层属性 | 紧跟在它**后面那一个 item** | 结构体、函数、枚举上方 | | ||
| | `#![attr]` | 内层属性 | 整个**作用域**(crate / 模块 / 块) | crate 根顶部、模块开头 | | | `#![attr]` | 内层属性 | 整个**作用域**(crate / 模块 / 块) | crate 根顶部、模块开头 | | ||
| 行 114: | 行 112: | ||
| `cfg` 控制**代码**是否编译;`cfg_attr` 控制某个**属性**是否被注入到所在的 item 上。 | `cfg` 控制**代码**是否编译;`cfg_attr` 控制某个**属性**是否被注入到所在的 item 上。 | ||
| - | |||
| ## 34.5 `derive`:派生 trait 的生成 | ## 34.5 `derive`:派生 trait 的生成 | ||
| 行 154: | 行 151: | ||
| } | } | ||
| ``` | ``` | ||
| - | |||
| ## 34.7 crate 级与模块级内层属性 | ## 34.7 crate 级与模块级内层属性 | ||
| 行 160: | 行 156: | ||
| | 内层属性 | 作用 | | | 内层属性 | 作用 | | ||
| - | |----------|------| | ||
| | `# | | `# | ||
| | `# | | `# | ||
| 行 173: | 行 168: | ||
| pub fn add(a: i32, b: i32) -> i32 { a + b } | pub fn add(a: i32, b: i32) -> i32 { a + b } | ||
| ``` | ``` | ||
| - | |||
| ## 34.8 其它常用属性一览 | ## 34.8 其它常用属性一览 | ||
| 行 179: | 行 173: | ||
| | 属性 | 作用 | | | 属性 | 作用 | | ||
| - | |------|------| | ||
| | `#[inline]` / `# | | `#[inline]` / `# | ||
| | `#[cold]` | 标记罕见路径(如错误分支),帮助优化 | | | `#[cold]` | 标记罕见路径(如错误分支),帮助优化 | | ||
| 行 191: | 行 184: | ||
| | 属性 | 作用 | | | 属性 | 作用 | | ||
| - | |------|------| | ||
| | `#[doc = " | | `#[doc = " | ||
| | `# | | `# | ||
| 行 234: | 行 226: | ||
| 4. **以为 `#[cfg]` 是运行时判断**:它只在编译期过滤,不会产生运行时分支。 | 4. **以为 `#[cfg]` 是运行时判断**:它只在编译期过滤,不会产生运行时分支。 | ||
| 5. **不确定某属性由谁实现**:先查是否内置,再查依赖是否提供对应过程宏,别瞎猜。 | 5. **不确定某属性由谁实现**:先查是否内置,再查依赖是否提供对应过程宏,别瞎猜。 | ||
| - | |||
| ## 34.12 小结 | ## 34.12 小结 | ||
| | 概念 | 要点 | | | 概念 | 要点 | | ||
| - | |------|------| | ||
| | 属性本质 | 元信息/ | | 属性本质 | 元信息/ | ||
| | 三种参数 | `# | | 三种参数 | `# | ||