首页/开发/CI/CD 与发布速查/锁文件原则(跨生态共通)
构建与制品管理58 条

锁文件原则(跨生态共通)

锁文件把「这次用的确切版本」固化下来:提交入库、CI 按锁安装、升级以变更单形式评审,是构建可复现的前提。

CI/CD 与发布速查开发更新于 2026-10-12

生态

生态锁文件还原命令
Node.jspackage-lock.json / yarn.lock / pnpm-lock.yamlnpm ci / yarn --frozen-lockfile
Pythonrequirements.txt(编译版)/ poetry.lock / uv.lockpip install -r / poetry install --sync
Gogo.sum(模块校验)go mod download
Maven无独立锁文件(Gradle 有)mvn -o dependency:resolve(离线复核)

通用规则

通用规则
1. 锁文件进版本库、进评审
2. CI 用「严格还原」命令而非「解析升级」命令
3. 升级走独立变更:diff 可读、风险可评估
Maven 生态惯用固定版本号(无锁文件):依赖解析确定性靠「版本固定 + 仓库不可变」共同保证。

易错点

  • 锁文件被 .gitignore 忽略:全队各自解析依赖,环境差异从依赖开始
  • 锁文件冲突随手重生成:可能连带升级无关包,冲突解决要审 diff

数据来源与参考

  • npm Docs《npm ci》
  • Poetry 文档
  • Go Modules Reference
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌