rust:属性

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版
前一修订版
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:
  
 | 内层属性 | 作用 | | 内层属性 | 作用 |
-|----------|------| 
 | `#![no_std]` | 不使用标准库,常用于嵌入式/内核 | | `#![no_std]` | 不使用标准库,常用于嵌入式/内核 |
 | `#![crate_name = "my_lib"]` | 显式命名 crate(较少用,一般走 Cargo) | | `#![crate_name = "my_lib"]` | 显式命名 crate(较少用,一般走 Cargo) |
行 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(always)]` | 建议编译器内联函数 | | `#[inline]` / `#[inline(always)]` | 建议编译器内联函数 |
 | `#[cold]` | 标记罕见路径(如错误分支),帮助优化 | | `#[cold]` | 标记罕见路径(如错误分支),帮助优化 |
行 191: 行 184:
  
 | 属性 | 作用 | | 属性 | 作用 |
-|------|------| 
 | `#[doc = "..."]` | 生成文档注释内容 | | `#[doc = "..."]` | 生成文档注释内容 |
 | `#[deprecated = "msg"]` | 标记废弃并提示 | | `#[deprecated = "msg"]` | 标记废弃并提示 |
行 234: 行 226:
 4. **以为 `#[cfg]` 是运行时判断**:它只在编译期过滤,不会产生运行时分支。 4. **以为 `#[cfg]` 是运行时判断**:它只在编译期过滤,不会产生运行时分支。
 5. **不确定某属性由谁实现**:先查是否内置,再查依赖是否提供对应过程宏,别瞎猜。 5. **不确定某属性由谁实现**:先查是否内置,再查依赖是否提供对应过程宏,别瞎猜。
- 
 ## 34.12 小结 ## 34.12 小结
  
 | 概念 | 要点 | | 概念 | 要点 |
-|------|------| 
 | 属性本质 | 元信息/指示,`#[...]` 外层、`#![...]` 内层 | | 属性本质 | 元信息/指示,`#[...]` 外层、`#![...]` 内层 |
 | 三种参数 | `#[name]`、`#[name = "v"]`、`#[name(key="v")]` | | 三种参数 | `#[name]`、`#[name = "v"]`、`#[name(key="v")]` |

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • rust/属性.1786552177.txt.gz
  • 最后更改: 2026/08/13 00:29
  • 由 张叶安