如何将Go模块伪版本转为Git完整提交哈希并同步静态文件？

一、从伪版本获取完整Git提交哈希 #

Go的伪版本（格式为vX.Y.Z-<时间戳>-<短哈希>）对应的完整提交哈希可以直接通过Go工具链获取，无需遍历分支，效率更高：

1. 提取api模块的版本和路径
   在controller仓库根目录执行以下命令，自动获取api模块的路径和当前依赖版本：

   API_MODULE=$(go list -m -f '{{.Path}}' github.com/yourname/api)
   API_VERSION=$(go list -m -f '{{.Version}}' github.com/yourname/api)
   

2. 获取完整提交哈希
   利用go mod download -json命令获取模块的详细元数据，从中提取完整哈希：

   # 用jq解析JSON（需提前安装jq）
   FULL_HASH=$(go mod download -json $API_MODULE@$API_VERSION | jq -r '.Revision')
   
   # 如果没有jq，用grep+cut替代
   FULL_HASH=$(go mod download -json $API_MODULE@$API_VERSION | grep -o '"Revision": "[^"]*"' | cut -d'"' -f4)
   

3. 更新子模块到对应版本
   拿到完整哈希后，直接更新稀疏检出的子模块：

   git submodule update --checkout api-static
   cd api-static
   git checkout $FULL_HASH
   cd ..
   

二、更简洁的替代方案 #

1. 用Go embed嵌入静态文件（推荐） #

如果静态文件允许嵌入到Go代码中，这是最可靠的方案：

• 在api模块中创建static.go，用embed包把静态文件嵌入：

  package api
  
  import "embed"
  
  //go:embed static/*  // 替换为你的静态文件目录
  var StaticFiles embed.FS
  

• controller代码中直接通过api.StaticFiles访问静态文件，无需额外同步操作。静态文件会随api模块的依赖版本自动同步到vendor目录，正式版和伪版本都适用。

2. 从模块缓存复制静态文件 #

如果无法修改api模块代码，可以利用Go的模块缓存目录复制文件：

# 获取api模块在缓存中的路径
API_DIR=$(go list -m -f '{{.Dir}}' github.com/yourname/api)

# 复制静态文件到controller的指定目录（比如vendor目录或自定义目录）
cp -r $API_DIR/static ./vendor/github.com/yourname/api/
# 或复制到其他需要的位置
cp -r $API_DIR/static ./api-static/

这个方案无需子模块，版本自动与vendor中的api依赖同步，伪版本也能正常工作。

方案对比 #

内容的提问来源于stack exchange，提问作者DonGiovanni