能否将纯数据非Go仓库转为Go模块并嵌入数据、同步上游？

一、解决fork后导入Go模块的404错误 #

你遇到的404 Not Found错误，核心原因是Go模块代理（sum.golang.org）无法找到你发布的模块版本，对应解决方法如下：

1. 校验版本标签规范与推送状态
   Go模块要求版本标签必须遵循语义化版本格式（如v0.0.1、v1.2.3），且需推送到远程仓库。执行以下命令确保标签正确：

   git tag v0.0.1
   git push origin v0.0.1
   

   若之前标签有误，先删除远程标签再重新推送：

   git push origin :v0.0.1
   

2. 等待代理索引或配置私有仓库规则

   • 公开仓库的新版本需要等待sum.golang.org同步（通常几分钟），可稍后重试go mod tidy。
   • 若为私有仓库，需配置环境变量跳过代理校验：

     export GOPRIVATE=github.com/org2/repo2
     

3. 检查go.mod文件的位置与内容
   确保go.mod在仓库根目录，且module指令与仓库路径完全一致：

   module github.com/org2/repo2
   
   go 1.16 // embed特性要求Go 1.16及以上版本
   

二、创建可嵌入非Go数据且能合并上游变更的Go模块 #

根据场景需求，推荐两种主流方案：

方案1：基于上游fork添加Go代码 #

适合需要频繁同步上游数据、且希望保留原文件结构的场景：

• 操作步骤：
  1. fork上游非Go仓库（github.com/org1/repo1）至自己的账号（github.com/org2/repo2）。
  2. 在fork仓库根目录执行go mod init github.com/org2/repo2初始化Go模块。
  3. 添加包含//go:embed指令的Go文件（如data.go）：

     package repo2
     
     import "embed"
     
     //go:embed *.json *.md // 根据上游数据类型调整匹配规则
     var DataFS embed.FS
     

  4. 定期同步上游变更：

     git remote add upstream https://github.com/org1/repo1
     git fetch upstream
     git merge upstream/main
     

• 注意：合并上游变更时，若文件结构调整，需同步修改//go:embed的匹配规则，解决代码与数据文件的冲突。

方案2：使用Git子模块关联上游仓库 #

适合不想修改上游fork、希望数据与代码分离的场景：

• 操作步骤：
  1. 创建新的Go模块仓库（github.com/org2/repo2）。
  2. 将上游非Go仓库作为子模块引入：

     git submodule add https://github.com/org1/repo1 data
     

  3. 在Go代码中嵌入子模块目录的文件：

     package repo2
     
     import "embed"
     
     //go:embed data/*.txt // 嵌入子模块data目录下的目标文件
     var DataFS embed.FS
     

  4. 同步上游变更时更新子模块：

     git submodule update --remote data
     

• 注意：其他用户克隆你的模块时，需添加--recurse-submodules参数，或手动初始化子模块；开发阶段可通过go mod replace指令指向本地子模块。

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