rust:属性

差别

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

到此差别页面的链接

后一修订版
前一修订版
rust:属性 [2026/08/12 23:12] – 创建 张叶安rust:属性 [2026/08/17 09:29] (当前版本) – [34.5 `derive`:派生 trait 的生成] 张叶安
行 9: 行 9:
 - 理解自定义过程宏属性(`#[derive]`、`#[proc_macro_attribute]`)如何被触发。 - 理解自定义过程宏属性(`#[derive]`、`#[proc_macro_attribute]`)如何被触发。
 - 能读懂以 `#![cfg_attr(not(debug_assertions), windows_subsystem = "windows")]` 为代表的真实属性。 - 能读懂以 `#![cfg_attr(not(debug_assertions), windows_subsystem = "windows")]` 为代表的真实属性。
- 
 ## 34.1 什么是属性:先回答"是宏吗" ## 34.1 什么是属性:先回答"是宏吗"
  
行 15: 行 14:
  
 | 语法 | 名称 | 特征 | 例子 | | 语法 | 名称 | 特征 | 例子 |
-|------|------|------|------| 
 | `#[...]` / `#![...]` | 属性 | 方括号 + 属性名,不写调用括号 | `#[derive(Debug)]`、`#![no_std]` | | `#[...]` / `#![...]` | 属性 | 方括号 + 属性名,不写调用括号 | `#[derive(Debug)]`、`#![no_std]` |
 | `name!(...)` | 声明式宏调用 | 名字加 `!` 加圆括号 | `println!`、`vec!` | | `name!(...)` | 声明式宏调用 | 名字加 `!` 加圆括号 | `println!`、`vec!` |
行 27: 行 25:
  
 所以严格地说,"属性是宏吗"要看它由谁实现:内置属性依赖编译器,属性宏本身是一种过程宏。但**语法上一律用方括号**,这一点和 `!()` 宏完全不同。 所以严格地说,"属性是宏吗"要看它由谁实现:内置属性依赖编译器,属性宏本身是一种过程宏。但**语法上一律用方括号**,这一点和 `!()` 宏完全不同。
- 
 ## 34.2 内层属性与外层属性 ## 34.2 内层属性与外层属性
  
行 33: 行 30:
  
 | 写法 | 名称 | 作用对象 | 典型位置 | | 写法 | 名称 | 作用对象 | 典型位置 |
-|------|------|----------|----------| 
 | `#[attr]` | 外层属性 | 紧跟在它**后面那一个 item** | 结构体、函数、枚举上方 | | `#[attr]` | 外层属性 | 紧跟在它**后面那一个 item** | 结构体、函数、枚举上方 |
 | `#![attr]` | 内层属性 | 整个**作用域**(crate / 模块 / 块) | crate 根顶部、模块开头 | | `#![attr]` | 内层属性 | 整个**作用域**(crate / 模块 / 块) | crate 根顶部、模块开头 |
行 116: 行 112:
  
 `cfg` 控制**代码**是否编译;`cfg_attr` 控制某个**属性**是否被注入到所在的 item 上。 `cfg` 控制**代码**是否编译;`cfg_attr` 控制某个**属性**是否被注入到所在的 item 上。
- 
 ## 34.5 `derive`:派生 trait 的生成 ## 34.5 `derive`:派生 trait 的生成
  
行 156: 行 151:
 } }
 ``` ```
- 
 ## 34.7 crate 级与模块级内层属性 ## 34.7 crate 级与模块级内层属性
  
行 162: 行 156:
  
 | 内层属性 | 作用 | | 内层属性 | 作用 |
-|----------|------| 
 | `#![no_std]` | 不使用标准库,常用于嵌入式/内核 | | `#![no_std]` | 不使用标准库,常用于嵌入式/内核 |
 | `#![crate_name = "my_lib"]` | 显式命名 crate(较少用,一般走 Cargo) | | `#![crate_name = "my_lib"]` | 显式命名 crate(较少用,一般走 Cargo) |
行 175: 行 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 其它常用属性一览
  
行 181: 行 173:
  
 | 属性 | 作用 | | 属性 | 作用 |
-|------|------| 
 | `#[inline]` / `#[inline(always)]` | 建议编译器内联函数 | | `#[inline]` / `#[inline(always)]` | 建议编译器内联函数 |
 | `#[cold]` | 标记罕见路径(如错误分支),帮助优化 | | `#[cold]` | 标记罕见路径(如错误分支),帮助优化 |
行 193: 行 184:
  
 | 属性 | 作用 | | 属性 | 作用 |
-|------|------| 
 | `#[doc = "..."]` | 生成文档注释内容 | | `#[doc = "..."]` | 生成文档注释内容 |
 | `#[deprecated = "msg"]` | 标记废弃并提示 | | `#[deprecated = "msg"]` | 标记废弃并提示 |
行 236: 行 226:
 4. **以为 `#[cfg]` 是运行时判断**:它只在编译期过滤,不会产生运行时分支。 4. **以为 `#[cfg]` 是运行时判断**:它只在编译期过滤,不会产生运行时分支。
 5. **不确定某属性由谁实现**:先查是否内置,再查依赖是否提供对应过程宏,别瞎猜。 5. **不确定某属性由谁实现**:先查是否内置,再查依赖是否提供对应过程宏,别瞎猜。
- 
 ## 34.12 小结 ## 34.12 小结
  
 | 概念 | 要点 | | 概念 | 要点 |
-|------|------| 
 | 属性本质 | 元信息/指示,`#[...]` 外层、`#![...]` 内层 | | 属性本质 | 元信息/指示,`#[...]` 外层、`#![...]` 内层 |
 | 三种参数 | `#[name]`、`#[name = "v"]`、`#[name(key="v")]` | | 三种参数 | `#[name]`、`#[name = "v"]`、`#[name(key="v")]` |

该主题尚不存在

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

  • rust/属性.1786547539.txt.gz
  • 最后更改: 2026/08/12 23:12
  • 由 张叶安