如何在Git仓库中规范记录项目所用工具的版本信息？

不要把版本信息零散写在代码注释、提交记录里，所有版本声明统一放在仓库根目录的标准命名文件中，分三类处理：

• 基础运行时版本记录
  根目录新建RUNTIME.md或者直接在README.md的开头「环境要求」章节明确标注底层依赖的精确版本，示例：

  项目运行所需基础环境：

  • GNU Bash：5.0.17(1)-release（依赖Bash 5.0数组特性，不兼容4.x及更低版本）
  • Python解释器：3.10.1（3.10以下版本缺失match语法支持，无法运行）
    标注版本的同时最好写清不兼容低版本的原因，其他人做适配的时候也有参考。

• Python依赖版本锁定
  不要手动列所有依赖，分两层管理，两个文件都提交到Git：
  1. 新建requirements.in，只写你项目中直接导入的第三方包和精确验证过的版本，比如你直接用到numpy就写numpy==1.21.1，其他间接依赖不需要手动维护。
  2. 生成全量锁定的依赖文件：如果本地环境是干净的虚拟环境，直接执行pip freeze > requirements.txt，会把所有直接、间接依赖的精确版本全部导出；如果想避免混入本地无关包，可以用pip-tools的pip-compile requirements.in命令生成带完整性校验的锁定文件，更干净。
     其他人复现时直接执行pip install -r requirements.txt就能装上和你开发环境完全一致的Python依赖。
• 增加自动化校验（可选，推荐）
  根目录写一个bootstrap.sh初始化脚本，自动做版本校验+依赖安装，避免人工核对版本出错，示例代码：

  #!/usr/bin/env bash
  set -e
  
  # 校验Bash版本
  TARGET_BASH="5.0.17"
  CURRENT_BASH="${BASH_VERSION%%(*}"
  if [ "$CURRENT_BASH" != "$TARGET_BASH" ]; then
      echo "❌ 环境校验失败：需要Bash $TARGET_BASH，当前版本$CURRENT_BASH"
      exit 1
  fi
  
  # 校验Python版本
  TARGET_PY="3.10.1"
  CURRENT_PY=$(python3 -c "import sys; print(f'{sys.version_info.major}.{sys.version_info.minor}.{sys.version_info.micro}')")
  if [ "$CURRENT_PY" != "$TARGET_PY" ]; then
      echo "❌ 环境校验失败：需要Python $TARGET_PY，当前版本$CURRENT_PY"
      exit 1
  fi
  
  echo "✅ 基础环境校验通过，开始安装依赖"
  pip install -r requirements.txt
  echo "✅ 环境初始化完成"
  

  给脚本加可执行权限后提交到Git，其他人拿到代码直接跑./bootstrap.sh就能完成环境校验和初始化，不用对着文档一个个核对版本。
• 配套注意事项
  • .gitignore里必须排除虚拟环境目录、Python缓存、本地配置文件，比如venv/、__pycache__/、.env，绝对不要把整个虚拟环境提交到仓库。
  • 不要给依赖写模糊的版本范围，比如别写numpy>=1.21，你在哪个版本上测试通过就先锁哪个精确版本，后续验证过其他版本兼容再调整，避免依赖包发新版改了逻辑导致复现失败。
  • README里要写清楚复现步骤，别光扔依赖文件，要明确告诉用户先装对应版本的基础运行时，再执行初始化脚本。

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