使用Git在HTML文件中实现JS文件自动版本控制

首先你完全没误解VCS的含义——传统集中式版本控制系统（比如SVN）确实普遍支持在提交时自动注入全局递增的revision number，但Git作为分布式版本控制系统，设计思路和它们不太一样：它没有单一的“中央版本号”，每个提交的哈希值是唯一标识，但不是连续的数字。不过我们依然可以通过几种方式实现类似的“自动注入版本标识”的效果，下面给你详细说明：

方法1：利用Git钩子在提交前自动替换文件占位符 #

如果你的需求是把版本标识直接写入源代码文件并随提交入库，可以用Git的pre-commit钩子实现自动替换：

• 先在你的代码里预留占位符，比如在src/version.h中写：

  #define APP_REVISION "@REVISION@"
  

• 在仓库的.git/hooks/目录下创建pre-commit脚本（注意文件名不能有后缀），内容如下：

  #!/bin/bash
  # 获取当前提交的短哈希值作为版本标识
  REV=$(git rev-parse --short HEAD)
  # 替换文件中的占位符
  sed -i "s/@REVISION@/$REV/g" src/version.h
  # 将修改后的文件加入本次提交
  git add src/version.h
  

• 给脚本添加执行权限：chmod +x .git/hooks/pre-commit
• 这样每次执行git commit时，脚本会自动替换占位符并把修改加入提交，最终代码里的版本号会同步为当前提交的短哈希。

⚠️ 注意：这种方式会修改源代码文件，可能会导致循环提交（比如脚本不小心修改了自身），建议只在必要场景使用，且确保脚本不会被误提交。

方法2：构建时动态注入版本标识（更推荐） #

Git的设计理念不鼓励在提交时修改文件（会污染提交历史），因此更推荐在构建阶段动态获取版本号，不需要修改源代码：

• 用Git自带的命令可以生成友好的版本字符串，比如：

  git describe --tags --dirty --always
  

  这个命令会输出类似v1.2-3-gabc123-dirty的字符串，含义是：距离最近的标签v1.2有3个提交，当前提交的短哈希是abc123，且工作区有未提交的修改。
• 在你的构建脚本中集成这个命令，比如Makefile：

  # 动态获取版本号
  VERSION := $(shell git describe --tags --dirty --always)
  # 把版本号作为宏定义传入编译过程
  CFLAGS += -DAPP_VERSION=\"$(VERSION)\"
  

• 之后在代码里直接使用APP_VERSION常量即可，编译后的程序就会包含当前的版本标识，全程不需要修改源代码，也不会影响Git提交历史。

方法3：使用Git的ident属性自动替换 #

Git内置了一个ident属性，可以自动替换文件中的特定占位符，步骤如下：

• 在仓库根目录创建.gitattributes文件，添加一行指定哪些文件启用该功能：

  *.c ident
  

• 在目标源代码文件中加入占位符：

  static const char app_version[] = "$Id$";
  

• 配置Git避免换行符干扰：git config core.autocrlf false
• 提交文件后，$Id$会被自动替换为$Id: abc1234567890abc1234567890abc1234567890 $，其中的字符串是对应提交的完整哈希。
• 注意：这个替换只会在Git的对象库中生效，工作区的文件依然显示$Id$，适合对版本标识需求简单的场景。

总结一下：你没有误解原回答中的VCS含义，只是Git的分布式特性决定了它没有集中式VCS那样的全局递增revision number，但通过上面的方法，完全可以实现类似的自动注入版本标识的效果，其中构建时动态注入是最符合Git设计思路的方案。

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