本技能主题为“R Metaprogramming with rlang”，面向需要在 R 中操作表达式、以编程方式构建代码，或需要理解 rlang 拆解与注入（defuse/inject）机制的开发者。
一、用途与核心模式 元编程指对 R 表达式进行拆解（defuse）、创建（create）和注入（inject）。核心模式是 defuse-and-inject：先把代码捕获为数据（计算蓝图），可选择性地转换，再注入到另一个上下文求值。
二、主要能力与速查 资料以速查表列出常见任务与对应函数：拆解自己的表达式用 expr(x + 1)；拆解用户单个参数用 enquo(arg)；拆解用户 ... 参数用 enquos(...)；注入单个表达式用 !! 或 {{ }}；拼接表达式列表用 !!!；从 quosure 取表达式用 quo_get_expr(q)、取环境用 quo_get_env(q)；从字符串构建符号用 sym("name")，构建带 .data 代词的符号用 data_sym("name")，从向量构建用 syms(names) / data_syms(names)；自动为表达式加标签用 as_label(quo)；把参数格式化为字符串用 englue("{{ x }}")；在动态点中插值名称用 "{name}" := value，插值参数标签用 "{{ arg }}" := value。
三、拆解表达式 拆解会停止求值，返回表达式对象（计算的蓝图）。例如 1 + 1 正常求值返回结果 2，而 expr(1 + 1) 返回表达式 1 + 1。expr() 拆解自己的代码并返回表达式，适合在本地构建表达式；enquo() 拆解用户参数并返回 quosure，适合转发函数参数；enquos() 拆解多个 ... 参数并返回 quosure 列表；enquos(..., .named = TRUE) 可为未命名参数自动加标签，如 g(cyl, 1 + 1) 得到名称 "cyl" 与 "1 + 1"。拆解后的表达式类型包括：调用（calls，如 f(x, y)、1 + 1）、符号（symbols，如 x、df）、常量（constants，如 1、"text"、NULL）。
四、Quosure 与环境的必要性 quosure 把表达式与其原始环境包装在一起，当表达式跨函数和跨包传递时，这对正确求值至关重要。资料给出示例：在包 A 中函数对用户参数使用 enquo()，再传给包 B 的函数时用 !! 注入，quosure 保证符号在正确环境中解析；否则代码跨包边界时符号可能解析到错误对象。判断是否使用 quosure：拆解函数参数用 enquo()（是）；构建本地表达式用 expr()（否）；跨包组合需要环境（是）；简单本地求值用 expr() + eval() 即可（否）。quosure 操作包括 quo_get_expr()、quo_get_env()，以及用 new_quosure() 手动创建、用 as_quosure() 把表达式转为 quosure。
五、注入运算符 {{ }}（embrace）一步完成拆解与注入，等价于 !!enquo(arg)，适合直接转发参数；当需要先检查或转换表达式时，则用 enquo() + !!。!!（bang-bang）注入单个表达式，例如 var <- expr(cyl) 后写成 mean(!!var)；也可注入值以避免名称冲突，如 df |> dplyr::mutate(x = x / !!x) 使用列 x 除以环境值 100。!!!（splice）把列表中的每个元素作为单独参数注入，如 vars <- exprs(cyl, am, vs) 后 select(!!!vars)，或 group_by(!!!enquos(...))。运算符生效的位置：数据掩码参数中隐式启用（dplyr、ggplot2 等）；inject() 可在任意上下文显式启用；动态点中 !!! 与 {name} 可用于使用 list2() 的函数；也可用 inject() 在基础函数中启用注入，如 inject(with(mtcars, mean(!!sym("cyl"))))。
六、从数据构建表达式 sym() / syms() 把字符串转为符号；data_sym() / data_syms() 创建 .data$col 表达式，在 tidy eval 中更安全、避免冲突。资料建议：基础 R 函数用 sym()，tidy eval 函数用 data_sym()。构建调用可用 call("mean", sym("x"), na.rm = TRUE)，或用 expr() 加注入。名称插值方面，动态点支持 glue 语法：变量值用 "{name}" := 1:3（可用 "prefix_{name}"），参数标签用 "mean_{{ var }}" := ...；englue() 可用于字符串格式化，如 englue("Column: {{ var }}") 返回 "Column: some_column"。
七、高级：手动表达式转换 需要注入前修改表达式时，按三步走：先拆解（enquo(var)），再转换（expr(mean(!!var, na.rm = TRUE)) 包装），最后注入（summarise(mean = !!wrapped)）。多参数场景可用 enquos(..., .named = TRUE) 取得列表后，用 purrr::map() 逐个转换，再 !!! 注入。
八、基础 R 对照 资料给出对照：expr() 对应 bquote()（bquote 用 .() 注入）；enquo() 对应 substitute()（substitute 返回裸表达式而非 quosure）；enquos(...) 对应 eval(substitute(alist(...)))；!! 对应 bquote 内的 .()；eval_tidy() 对应 eval()（eval_tidy 支持 .data/.env 代词）。
九、限制与陷阱 {{ }} 只能包裹函数参数，对普通对象会捕获其值而非表达式（如 x <- 1 时 {{ x }} 返回 1）。在 tidy eval / inject 上下文之外，运算符含义不同且会静默失效：{{ }} 变成双花括号返回值，!! 变成双重逻辑取反，!!! 变成三重逻辑取反。相关主题可参考 tidy-evaluation、designing-tidy-r-functions、rlang-conditions 等技能。
十、参考资料与获取方式 参考文件包括 topic-quosure.md（quosure 完整参考）、topic-metaprogramming.md（高级转换模式）、topic-multiple-columns.md（多列模式）。可通过 R 访问 vignette：vignette("topic-defuse", package = "rlang")、vignette("topic-inject", package = "rlang")，或用 browseVignettes("rlang") 浏览全部。