Git拉取/克隆/获取时自动格式化方案，及Shell代码双向格式化工具问询

一、双向格式化：兼顾团队规范与个人习惯 #

首先得说，目前没有专门做「双向风格切换」的格式化工具，但用你已经在考虑的shfmt就能完美实现需求，核心思路是配置分离：

团队仓库统一规范 #

在仓库根目录放置一个.shfmt配置文件，把团队敲定的格式化参数写进去，比如：

-i 2       # 缩进用2个空格
-bn        # 移除if/for语句后的空行
-ci        # 缩进case语句的内容块
-sr        # 重定向符号前添加空格

然后在pre-commit钩子中执行shfmt -w .——shfmt会自动读取当前目录的.shfmt配置，确保提交到仓库的代码全是统一风格，这部分你应该已经有初步规划了。

个人本地编辑用自定义风格 #

你完全可以在本地单独配置shfmt的参数，不用改动仓库的统一配置：

• 如果用VS Code，安装shell-format插件后，在设置里把shellformat.flag改成你习惯的参数（比如-i 4 -bn），编辑时会自动按你的风格格式化代码。
• 要是偏好命令行操作，就在用户目录下创建~/.config/shfmt文件，写入你的个人配置。注意shfmt会优先读取当前目录的配置，所以本地想转成自己风格时，手动执行shfmt --config ~/.config/shfmt -w 你的脚本.sh即可。

其他Shell格式化工具比如beautysh我也试过，但shfmt和你们的Go技术栈更契合，稳定性也更强，还是优先用它更省心。

二、Git拉取/克隆时自动格式化的现成方案 #

Git本身没有内置的post-clone/post-pull钩子，但有几个现成方案，不用自己写复杂的包装脚本：

最省心方案：用pre-commit框架 #

pre-commit不只是做提交前检查，它还支持post-checkout和post-merge钩子，刚好覆盖你的场景：

• 先安装pre-commit（用pip或brew都可以）
• 在仓库的.pre-commit-config.yaml中添加本地钩子：

  repos:
    - repo: local
      hooks:
        - id: shfmt
          name: shfmt格式化Shell代码
          entry: shfmt -w
          language: system
          files: '\.(sh|bash)$'
  

• 执行钩子安装命令：

  pre-commit install --hook-type post-checkout --hook-type post-merge
  

  这样，clone仓库时（clone完成后会自动触发checkout）、pull代码时（合并或快进操作会触发merge），都会自动用shfmt格式化所有Shell文件，完全不用手动干预。

备选方案：Git全局钩子模板 #

要是不想用pre-commit，也可以配置Git全局钩子模板：

• 创建一个全局钩子目录，比如~/.git-templates/hooks
• 在该目录下创建post-checkout和post-merge脚本，内容示例：

  #!/bin/sh
  # 先判断是否为团队的Shell项目（比如检查是否存在.shfmt配置文件）
  if [ -f .shfmt ]; then
    echo "自动格式化Shell代码..."
    shfmt -w .
  fi
  

• 给脚本添加执行权限：chmod +x ~/.git-templates/hooks/post-checkout ~/.git-templates/hooks/post-merge
• 告诉Git使用这个全局模板：git config --global init.templateDir ~/.git-templates
  后续clone的仓库都会自动带上这些钩子，执行git pull或切换分支时就会自动格式化代码。已有的仓库需要重新执行git init才能应用模板（不会修改现有代码，放心操作）。

补充说明：git fetch本身不会触发任何钩子，因为它只是拉取远程数据，不会修改本地工作区。如果需要fetch后自动格式化，等你切换到基于fetch新数据的分支时，post-checkout钩子会自动触发格式化操作。

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