如何在Node.js中通过编程读取最新Commit Hash？

方案一：直接读取分支引用文件（更优） #

其实不用读日志文件，.git/refs/heads/master文件里直接存着当前master分支的最新commit hash，内容就是一行纯文本的40位hash值，读取起来更简单高效。

代码示例：

const fs = require('fs');
const path = require('path');

function getLatestCommitHash() {
  try {
    // 读取master分支的引用文件
    const hash = fs.readFileSync(path.join(__dirname, '.git/refs/heads/master'), 'utf8').trim();
    return hash;
  } catch (err) {
    console.error('读取commit hash失败:', err.message);
    return null;
  }
}

// 使用
console.log(getLatestCommitHash());

方案二：读取日志文件（你提到的方法） #

读取.git/logs/refs/heads/master的思路是可行的，这个文件的每一行记录了分支的变更历史，格式为：旧HASH 新HASH 作者 <邮箱> 时间戳 时区，最后一行的第二个字段就是最新的commit hash。

代码示例：

const fs = require('fs');
const path = require('path');

function getLatestCommitHashFromLog() {
  try {
    const logContent = fs.readFileSync(path.join(__dirname, '.git/logs/refs/heads/master'), 'utf8');
    // 按行分割，过滤空行，取最后一行
    const lines = logContent.split('\n').filter(line => line.trim() !== '');
    if (lines.length === 0) return null;
    const lastLine = lines[lines.length - 1];
    // 分割后第二个元素就是最新hash
    const commitHash = lastLine.split(' ')[1];
    return commitHash;
  } catch (err) {
    console.error('读取日志文件失败:', err.message);
    return null;
  }
}

// 使用
console.log(getLatestCommitHashFromLog());

需要注意的陷阱 #

• .git文件夹的存在性：如果是生产环境或者打包后的代码，.git文件夹通常会被忽略或删除，这时候这两种方法都会失效。
• 引用文件的更新机制：如果使用git update-ref这类底层命令直接修改分支引用，而不是常规的commit、merge、reset操作，日志文件不会追加记录，但引用文件（refs/heads/master）依然会更新，所以方案一更可靠。
• 编码问题：读取文件时一定要指定utf8编码，避免因默认编码导致的hash乱码。
• 空行处理：日志文件末尾可能存在空行，必须先过滤空行再取最后一行，否则会解析出错。
• 分支切换：虽然你假设只有master分支，但如果后续切换分支，方案一需要对应修改读取的文件路径，或者先读取.git/HEAD文件动态获取当前分支的引用路径。

进阶优化：动态适配当前分支 #

如果需要兼容分支切换的场景，可以先读取.git/HEAD获取当前分支的引用，再读取对应的hash：

const fs = require('fs');
const path = require('path');

function getCurrentBranchCommitHash() {
  try {
    // 读取HEAD文件，获取当前分支引用
    const headContent = fs.readFileSync(path.join(__dirname, '.git/HEAD'), 'utf8').trim();
    if (!headContent.startsWith('ref:')) {
      // 处于detached HEAD状态，HEAD文件直接存hash
      return headContent;
    }
    // 解析出引用路径
    const refPath = headContent.split(' ')[1];
    // 读取对应的引用文件
    const hash = fs.readFileSync(path.join(__dirname, '.git', refPath), 'utf8').trim();
    return hash;
  } catch (err) {
    console.error('获取commit hash失败:', err.message);
    return null;
  }
}

// 使用
console.log(getCurrentBranchCommitHash());

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