解决git-quick-stats在macOS上的GNU date依赖问题

git-quick-stats是一个强大的Git仓库统计工具，但在macOS系统上使用时可能会遇到GNU date依赖问题。本文将详细介绍这个问题的原因和解决方案。

问题现象

当在macOS上运行git-quick-stats时，可能会出现如下错误提示：

ERROR: You must have GNU date installed.
If you're on macOS, please use brew to install this utility.
Make sure the GNU version of date is symlinked to 'date', too.

问题原因

macOS系统默认使用的是BSD版本的date命令，而git-quick-stats需要GNU版本的date工具。这两个版本在功能参数上有差异，导致工具无法正常工作。

解决方案

1. 安装GNU coreutils

首先需要通过Homebrew安装GNU coreutils工具集：

brew install coreutils

2. 配置PATH环境变量

安装完成后，需要将GNU工具路径添加到系统PATH中。根据不同的Mac芯片架构，路径有所不同：

对于Intel芯片Mac：

export PATH="/usr/local/opt/coreutils/libexec/gnubin:$PATH"

对于Apple Silicon芯片(M1/M2)Mac：

export PATH="/opt/homebrew/opt/coreutils/libexec/gnubin:$PATH"

3. 验证安装

可以通过以下命令验证GNU date是否安装成功：

date --version

如果显示类似以下信息，则表示安装成功：

date (GNU coreutils) 9.5
Copyright (C) 2024 Free Software Foundation, Inc.
...

4. 永久配置（可选）

为了使配置永久生效，可以将PATH配置添加到shell配置文件中（如~/.zshrc或~/.bashrc）：

echo 'export PATH="$HOMEBREW_PREFIX/opt/coreutils/libexec/gnubin:$PATH"' >> ~/.zshrc
source ~/.zshrc

替代方案

如果不想修改全局PATH，也可以创建别名：

alias date="gdate"

注意事项

1. 不同版本的Homebrew可能会将coreutils安装在不同路径，可以使用以下命令查找gnubin目录：

find /opt /usr -type d -name gnubin

2. 确保在安装coreutils后重新启动终端，使配置生效。

3. 如果使用Nix包管理器，可以直接通过以下命令使用：

nix-shell -p git-quick-stats

通过以上步骤，即可解决git-quick-stats在macOS上的GNU date依赖问题，正常使用这个强大的Git统计工具。