在github actions上缓存golang依赖能显著加快ci流程中的go mod download速度。通过配置actions/cache action，可复用已下载的依赖包，避免重复下载。具体步骤：1. 指定缓存路径为~/go/pkg/mod和~/.cache/go-build；2. 使用go.sum文件哈希生成缓存key，并建议包含go版本信息；3. 设置restore-keys以便匹配历史缓存。注意事项包括：不同go版本可能导致缓存失效；私有模块需确保ci权限；缓存保留7天；避免多个job并发写同一缓存key。启用缓存后，原本耗时5~10秒的下载过程可几乎瞬间完成，大幅提升ci效率。
在GitHub Actions上缓存Golang依赖，能显著加快CI流程中go mod download这一步的速度，尤其是在频繁触发的流水线里。直接讲重点：通过正确配置缓存步骤，可以避免每次构建都重新下载依赖包，节省时间并减少网络请求。
为什么需要缓存Go依赖？
Go项目通常使用go mod管理依赖，在CI环境中每次运行都会执行go mod download来拉取模块。如果每次都从远程下载，不仅耗时还可能受网络影响。
缓存的作用就是：把第一次下载好的依赖保存下来，后续构建直接复用，大幅提升效率。
如何配置缓存步骤？
GitHub Actions提供了官方的缓存Action：actions/cache，我们可以用它来缓存Go的模块目录。以下是一个典型配置示例：
- name: Cache Go modules
uses: actions/cache@v4
with:
path: |
~/go/pkg/mod
~/.cache/go-build
key: ${{ runner.os }}-go-${{ hashFiles('**/go.sum') }}
restore-keys: |
${{ runner.os }}-go-关键点说明：
-
path: 要缓存的路径，Go模块默认是~/go/pkg/mod，编译缓存建议加上~/.cache/go-build -
key: 缓存的唯一标识，推荐基于go.sum内容做哈希，这样依赖变更会自动刷新缓存 -
restore-keys: 回退使用的缓存前缀，用于匹配历史缓存
常见问题与注意事项
-
Go版本差异可能导致缓存失效：不同Go版本下载的模块结构可能不一样，所以建议在缓存key中加入Go版本信息（如
go1.21）。 - 私有模块要小心处理：如果你用了私有仓库的依赖，确保CI有权限访问，否则缓存也无法正常恢复。
- 缓存不是永久的：GitHub缓存保留时间为7天，超过未更新会被清除。
- 并发写缓存会有冲突：多个Job同时写同一个缓存key会导致失败，建议只在一个Job中写入缓存。
实际优化效果如何？
一次典型的go mod download操作在无缓存情况下可能需要5~10秒甚至更久，尤其当依赖较多或网络不佳时。启用缓存后，这个过程几乎瞬间完成，整个CI流程提速明显。
立即学习“go语言免费学习笔记（深入）”；
如果你的项目每天跑几十次CI，这种优化积少成多，体验提升很直观。
基本上就这些。配置起来不复杂，但有几个细节容易忽略，比如路径是否正确、key是否稳定、是否和Go版本绑定等。只要注意这几个点，就能顺利实现Go依赖的缓存加速。
