条目字段引用
字段引用是一段特殊文本,会被替换为另一个条目中的值。这类似于电子表格中的单元格可以获取并组合其他单元格的数据。
当你需要在不同条目中使用同一份数据时,字段引用非常有用。例如,你的公司使用单点登录,你需要用同一套凭据(即工作账户)登录不同的网络服务。这时无需把密码复制到每个条目,只需插入对"主"工作账户的引用即可:

每当你更改主条目的密码时,所有引用它的条目都会自动更新。
创建字段引用
创建字段引用最简单的方式是:轻点该字段,然后在弹出菜单中轻点 复制字段引用 按钮。

这样,该字段的引用就会被拷贝到剪贴板,你可以将它粘贴到任何其他条目的任意字段中。
你也可以按照下文介绍的字段引用格式手动构建引用。
使用字段引用
字段引用可用于任何条目的任意字段,你可以像粘贴普通文本一样从剪贴板粘贴它们。在编辑条目时,界面会显示引用的原始文本,看起来并不直观。

一旦保存条目,这段复杂的引用文本就会被替换为它所指向的值。
字段引用会在数据库加载或保存时解析。因此无法引用 OTP 之类的动态值。不过,你可以引用 OTP 配置字段,这样该条目就能独立生成相同的 OTP 值。
TIP
KeePassium 支持嵌套引用:Field C 引用 Field B,而后者又引用 Field A。应用最多会向上追溯 3 层引用来解析字段值。
如果字段引用出现问题,它会以原始的 {REF:…} 形式显示。可能的问题包括:
- 引用格式错误
- 引用了不存在的条目或字段
- 在条目之外使用了引用
- 嵌套引用层数过深
- 嵌套引用形成循环(字段值最终引用了自身)
仅限条目
字段引用在条目字段之外无法使用。
仅限同一数据库
字段引用只能在同一个数据库内使用。若要加快访问其他数据库,请使用链接的数据库。
字段引用格式
在底层,字段引用是一段纯文本表达式,格式如下:
{REF:fieldIdentifier@entrySearchCondition}
为便于阅读,下面是加入了额外空格的同一表达式:
{REF: fieldIdentifier @ entrySearchCondition }
引用需符合以下五个要点:
- 用
{花括号}包裹 - 以
REF:前缀开头 - 包含一个字段标识符——用单个字母表示要引用的字段。
- 字段标识符后跟
@分隔符 - 分隔符之后是条目搜索条件——一个用于确定所引用条目的表达式。
字段标识符
字段标识符可以是以下字母之一:
T— 标题U— 用户名P— 密码A— URLN— 备注
例如,{REF:P@ … } 表示我们想获取该条目的密码值。
条目搜索条件
条目搜索条件本身也是一个表达式,由字段标识符字母、: 分隔符以及指定字段的_精确_值组成。例如,T:My Work Account 引用第一个标题恰好为"My Work Account"的条目。
条目搜索条件支持更多字段标识符:
T— 标题U— 用户名P— 密码A— URLN— 备注I— UUID。搜索值应为条目的唯一标识符,你可以在条目查看器的最后一个标签页中找到该值。O— 自定义字段。搜索值是自定义字段的_名称_。这与其他字段不同——其他字段的搜索值是与字段的_值_进行比较的。
示例
{REF:U@I:327FCC13-07F5-4AB4-97D9-78486148B729}— 查找具有指定 UUID 的条目,并获取其用户名字段。{REF:P@T:Amazon}— 查找标题为"Amazon"的条目,并获取其密码字段。{REF:T@O:PIN Code}— 查找带有名为"PIN Code"的自定义字段的条目,并获取其标题字段。
占位符
占位符是对_同一_条目中另一个字段的简化引用。KeePassium 支持一种占位符格式:{S:fieldName}。
例如,若存在名为"PIN Code"的自定义字段,文本 {S:PIN code} 会被替换为该字段的值。
TIP
标准字段的名称为 Title、UserName、Password、URL、Notes。字母大小写很重要:username 或 Username 都无效。
兼容性
KeePassium 的字段引用与 KeePass 和 KeePassXC 兼容。由 KeePassium 创建的引用可在这些应用中正常工作,反之亦然。
不过,由于需求较少,KeePassium 不支持这些应用中的大多数条目占位符。唯一支持的占位符是 {S:fieldName},用于引用同一条目中的另一个字段。