核心是三步:安装git lfs(推荐brew install git-lfs)、运行git lfs install启用钩子、用git lfs track声明跟踪规则并提交.gitattributes;此后add/commit/push流程完全透明,匹配文件自动以指针存储并同步上传实际大文件。
在 macos 上配置 git lfs,核心是三步:安装工具、启用扩展、声明跟踪规则。整个过程对日常 git 操作完全透明,不需要改变你原有的 add/commit/push 流程。
安装 Git LFS(推荐 Homebrew)
确保已安装 Homebrew(如未安装,先运行 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)")。然后执行:
brew install git-lfs- 验证安装:
git lfs version应输出类似git-lfs/3.6.1的版本信息
全局或仓库级初始化
Git LFS 钩子需显式启用,建议在每个需要 LFS 的项目目录中运行:
-
git lfs install—— 为当前仓库设置 pre-push 等钩子 - 该命令不会影响其他仓库,也无需加
--global(除非你确定所有项目都统一启用)
定义哪些文件走 LFS 存储
用 git lfs track 命令声明文件模式,例如:
git lfs track "*.psd"git lfs track "data/*.zip"git lfs track "models/**/*.bin"
执行后,规则会写入项目根目录下的 .gitattributes 文件,记得把它加入提交:git add .gitattributes && git commit -m "Enable LFS for PSD and ZIP files"。
后续使用和注意事项
完成上述步骤后,所有匹配的文件在 git add 时自动转为指针存储,git push 会同步指针 + 上传实际大文件到 LFS 服务器(如 GitHub、GitLab 或自建 LFS 服务)。注意:
- 远程仓库必须支持 LFS(GitHub/GitLab 默认支持;私有 Git 服务器需额外部署 LFS 对象存储)
- 已有大文件的历史提交不会被自动迁移,如需瘦身旧仓库,需配合
git filter-repo工具重写历史 - 克隆时若想自动下载 LFS 文件内容,需确保本地已运行过
git lfs install,否则只拉取指针











