Typst跨文件引用标签报错：单独编译子文件时标签不存在

针对Typst分文件编译时跨文件标签无法识别的问题，提供两种实用方案：

方案一：共享标签声明文件 #

通过单独的标签文件统一管理跨文件引用的标签，让子文件编译时能获取标签定义：

1. 新建labels.typ文件，声明需要跨文件引用的标签：

#let fig_1 = label("fig_1")

2. 在ch_1.typ中导入标签文件，并关联到实际图片：

#import "labels.typ": *

#figure(
  image("fig_1"),
  caption: "示例图1",
  label: fig_1,
)

3. 在ch_2.typ中导入标签文件，即可正常引用：

#import "labels.typ": *

参考图@fig_1

4. main.typ保持原有导入逻辑：

#import "ch_1.typ"
#import "ch_2.typ"

#ch_1
#ch_2

这种方式的优势是标签管理集中，适合多文件共享多个标签的场景，不会出现重复定义冲突。

方案二：条件引入依赖内容 #

在子文件中判断是否为单独编译，单独编译时生成占位标签（隐藏显示），被主文件导入时跳过：

修改ch_2.typ如下：

// 判断当前是否为单独编译的根文档
#if ctx.root == this {
  // 生成占位的标签关联，隐藏实际显示
  #hide: figure
  #figure(
    image("fig_1"),
    label: label("fig_1"),
  )
}

// 正常引用标签
参考图@fig_1

单独编译ch_2.typ时，编译器会识别到fig_1标签（内容被隐藏不显示）；主文件编译时，因为ch_1.typ已经加载了实际图片，不会产生冲突。

这种方式无需额外文件，适合少量跨文件引用的场景，灵活性较高。

内容的提问来源于stack exchange，提问作者ムータンーオ