在Golang的模块化开发中，当我们需要引用还没有正式发布版本的依赖包时，常规的版本号引用方式无法生效，这时候就需要使用polang module提供的pseudo version（伪版本）机制来实现依赖引用。
什么是pseudo version
pseudo version是Golang module系统为没有打正式版本标签的提交生成的一种特殊版本标识，它的格式通常为vX.0.0-yyyymmddhhmmss-abcdefabcdef，其中各个部分的含义如下：
- vX.0.0：基础版本号，通常基于该提交所在分支的已有版本推导，若没有已有版本则使用v0.0.0
- yyyymmddhhmmss：提交的时间戳，精确到秒
- abcdefabcdef：提交的哈希值前12位
引用未发布依赖的场景
常见的需要使用pseudo version的场景包括：
- 依赖包作者还没有为最新提交打版本标签，我们需要使用最新的开发内容
- 依赖包存在严重bug，官方修复后还没有发布新版本，需要临时引用修复后的提交
- 我们fork了某个开源包，修改后还没有发布自己的版本，需要在项目中引用自己的fork仓库
pseudo version使用步骤
1. 获取依赖包的提交信息
首先我们需要找到要引用的依赖包的具体提交哈希和时间戳，如果是公共仓库可以直接在代码托管平台查看，如果是私有仓库可以通过git命令获取：
# 克隆依赖仓库到本地 git clone https://ipipp.com/example/utils.git cd utils # 查看最新提交的哈希和时间戳 git log -1 --pretty=format:"%H %ci"
执行后会得到类似a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0 2024-05-20 14:30:25 +0800的输出，其中前面的字符串是完整提交哈希，后面的时间是提交时间。
2. 生成pseudo version标识
根据获取到的信息生成符合格式的pseudo version，假设基础版本是v0.0.0，提交时间是2024年5月20日14点30分25秒，提交哈希前12位是a1b2c3d4e5f6，那么生成的pseudo version就是v0.0.0-20240520143025-a1b2c3d4e5f6。
3. 修改go.mod文件引用依赖
打开项目的go.mod文件，添加或修改对应的依赖项，格式如下：
module myproject
go 1.21
require (
ipipp.com/example/utils v0.0.0-20240520143025-a1b2c3d4e5f6
)
4. 执行依赖拉取命令
修改完go.mod后，执行以下命令拉取依赖：
go mod tidy
命令执行成功后，go.sum文件会自动生成对应的依赖校验信息，此时就可以在项目中正常引用该未发布的依赖包了。
使用注意事项
- pseudo version对应的提交必须是不可变的，如果你引用的提交后续被force push修改，会导致依赖校验失败，因此尽量不要引用频繁变动的分支最新提交
- 如果依赖包后续发布了正式版本，建议及时将pseudo version替换为正式版本号，避免后续维护出现问题
- 引用私有仓库的未发布依赖时，需要确保本地git配置了正确的仓库访问权限，否则go mod tidy会拉取失败
- 不要手动随意编写pseudo version字符串，建议通过
go get命令自动生成，避免格式错误，例如执行go get ipipp.com/example/utils@a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0会自动生成正确的pseudo version并更新go.mod
常见问题解答
执行go mod tidy提示依赖找不到怎么办
首先检查pseudo version的格式是否正确，其次确认提交哈希是否准确，最后检查仓库地址是否可以正常访问，如果是私有仓库需要配置GOPRIVATE环境变量：
go env -w GOPRIVATE=ipipp.com/example
pseudo version可以引用本地未提交的修改吗
不可以，pseudo version只能引用已经推送到远程仓库的提交，本地未提交的修改无法通过该方式引用，本地开发测试可以使用replace指令指向本地路径：
replace ipipp.com/example/utils => ../local_utils
Golangmodulepseudo_version依赖引用修改时间：2026-06-23 02:03:30