CUE语言中如何标记不可移除的模块依赖

在CUE语言的项目开发过程中，模块依赖管理是一个重要环节。当使用cue mod tidy命令清理未使用的依赖时，有时会遇到需要保留某些特定依赖的情况，即使这些依赖在当前模块中没有被直接引用。

问题背景

在CUE项目中，我们可能会使用cue vet命令来验证数据文件是否符合某个远程模块中的包定义。例如：

cue vet <some-module-from-a-registry/some-package> data.yml

这个命令能够正常工作，前提是该远程模块已经被添加为当前项目的依赖（通过cue mod get命令）。然而，如果这个依赖没有被当前模块中的任何CUE文件直接引用，执行cue mod tidy时就会被自动移除，导致后续的cue vet命令失效。

解决方案

CUE核心团队提出了两种解决方案：

1. 创建虚拟引用文件

可以创建一个专门的CUE文件来显式引用需要保留的依赖：

// preserve-deps.cue
package _deps
import p "<some-module-from-a-registry>"
_p: p    // 避免"unused import"错误

这种方法通过创建一个专门的包来维护依赖关系，确保目标模块不会被cue mod tidy移除。

2. 使用条件编译标记

更符合CUE语言设计理念的方式是使用条件编译标记：

// deps.cue
@if(deps)
package deps

import _ "github.com/cue-tmp/jsonschema-pub/exp3/githubactions"

同时需要在cue.mod/module.cue中明确声明依赖：

// cue.mod/module.cue
module: "mod.com"
language: {
    version: "v0.12.0"
}
deps: {
    "github.com/cue-tmp/jsonschema-pub/exp3/githubactions@v0": {
        v:       "v0.2.0"
        default: true
    }
}

未来展望

CUE团队已经意识到这是一个更广泛需求的具体表现，计划在未来版本中实现cue vet $pkg@$version的功能，这将从根本上解决此类问题。在此之前，上述两种方法都是可行的临时解决方案。

最佳实践建议

对于需要长期维护的项目，建议：

1. 为所有工具性依赖创建专门的引用文件
2. 在项目文档中明确说明这些依赖的用途
3. 考虑将这些依赖管理文件放在项目特定的目录中，如build/或scripts/

这种方法不仅能解决当前问题，还能提高项目的可维护性和团队协作效率。