如何复制pre-commit钩子？Linux无网环境部署技术问询

1. 定位联网机器上的钩子存储位置 #

pre-commit的钩子分为两部分存储：

• 项目本地触发脚本：位于项目根目录的 .git/hooks/pre-commit，这是pre-commit安装后生成的触发钩子的核心脚本。
• 钩子缓存与依赖包：全局缓存目录 ~/.cache/pre-commit/，这里包含所有已安装钩子的仓库代码、虚拟环境、二进制依赖等，是离线部署的关键资源。

2. 打包联网机器上的必要文件 #

在联网机器上执行以下命令打包资源：

# 打包项目配置文件与钩子触发脚本
tar -czf pre-commit-project.tar.gz .pre-commit-config.yaml .git/hooks/pre-commit

# 打包全局钩子缓存目录
tar -czf pre-commit-cache.tar.gz ~/.cache/pre-commit/

3. 传输到离线Linux机器 #

通过U盘、内网SCP等方式，将两个压缩包传输到离线机器的目标项目目录或临时目录。

4. 在离线机器上完成部署 #

前置检查：确认pre-commit已安装 #

如果离线机器未安装pre-commit，需先从联网机器下载对应版本的wheel包（如pre-commit-xxx-py3-none-any.whl），然后离线安装：

pip install pre-commit-xxx-py3-none-any.whl

解压并部署文件 #

# 解压项目文件到项目根目录
tar -xzf pre-commit-project.tar.gz -C /path/to/your/project/

# 解压缓存目录到用户主目录
tar -xzf pre-commit-cache.tar.gz -C ~/

# 给钩子脚本添加执行权限
chmod +x /path/to/your/project/.git/hooks/pre-commit

完成钩子本地化安装 #

在项目根目录运行以下命令，该操作会读取本地缓存的钩子资源，无需联网：

pre-commit install --install-hooks

注意事项 #

• 确保联网机器与离线机器的CPU架构一致（如均为x86_64），否则部分二进制类型的钩子可能无法正常运行。
• 如果缓存目录复制到不同用户下，需调整目录权限确保当前用户可读写：chmod -R u+rwx ~/.cache/pre-commit/

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