分支切换卡顿通常是因为 Git LFS 在检出时自动下载大文件，最直接的解决方式是改为手动控制下载时机，适合网络不稳定或大文件较多的仓库。
先说结论：开启 skip-smudge 模式可避免 checkout 时自动拉取，但需要手动管理文件下载
- 适合：大文件多、网络环境差或频繁切换分支的场景
- 先准备：确认当前 LFS 状态并备份重要配置
- 验收：切换分支时无明显等待，需要文件时手动拉取
命令速用版
git lfs install `--skip-smudge`
git lfs pull第一条命令关闭自动下载，第二条命令在需要时手动获取文件。
为什么会这样
Git LFS 默认使用 smudge 过滤器，在你执行 git checkout 或 git clone 时，会自动把指针文件替换成实际的大文件内容。如果分支切换涉及大量 LFS 文件变动，系统会尝试立即下载这些文件，网络慢或文件大时就会卡住。关闭 smudge 后，检出时只保留指针文件，不占用带宽和磁盘 IO，直到你明确需要时才下载。
分步处理
1. 检查当前 LFS 状态
执行 git lfs status 查看是否有待推送或拉取的文件。同时运行 git config filter.lfs.process 确认过滤器是否已启用，预期输出应为 git-lfs filter-process。
2. 安装 skip-smudge 模式
在仓库根目录运行：
git lfs install `--skip-smudge`这会修改本地 Git 配置，禁用检出时的自动过滤。注意这仅影响当前仓库的本地配置。
3. 重置工作区指针（关键步骤）
配置完成后，执行 git checkout -- . 可安全恢复为指针文件而不下载内容。避免直接手动删除文件，以防工作区状态混乱或数据丢失。
4. 需要文件时手动拉取
当你要编译或运行项目时，执行：
git lfs pull这会下载当前分支所需的所有 LFS 文件。
5. 回滚配置
如果发现不便，可运行 git lfs install `--force` 恢复默认自动下载行为。
怎么验证是否生效
1. 观察切换速度
执行 git checkout <branch>，观察是否还有长时间的网络等待。开启 skip-smudge 后，切换应几乎瞬间完成。
2. 检查文件状态
查看大文件内容，如果是文本指针（显示 version https://git-lfs...），说明未下载；如果是二进制内容，说明已下载。也可用 git lfs ls-files 确认哪些文件已本地存在。
3. 验证配置项
运行 git config filter.lfs.process，确保配置未被意外重置。
常见坑
1. 编译失败
忘记执行 git lfs pull 就直接构建，会导致文件缺失或内容错误。建议在构建脚本中加入自动拉取步骤。
2. CI/CD 环境差异
流水线环境通常默认自动拉取，本地改为手动后，需确保脚本行为一致，避免本地能跑线上报错。
3. 多人协作沟通
如果团队其他人未配置 skip-smudge，他们切换分支仍会卡顿。这是本地配置，不会同步给他人，需团队内部约定。
参考来源
- Git LFS 官方文档 - Command Reference: git-lfs-install
- Git LFS 官方 Wiki - Performance
原文链接：https://www.zjcp.cc/ask/11135.html