Git LFS 跨平台安装指南：Linux、macOS 与 Windows

三、Windows 系统安装指南

3.1 Chocolatey 包管理器安装

# 以管理员身份打开 PowerShell
Set-ExecutionPolicy Bypass -Scope Process -Force
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072
iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
# 安装 Git LFS
choco install git-lfs -y
# 验证安装（需重新打开命令提示符）
git lfs version

3.2 官方安装程序

1. 下载最新 Windows 安装包：git-lfs-windows-amd64.exe
2. 双击运行安装程序，按照向导完成安装
3. 安装完成后，打开命令提示符验证：git lfs version

3.3 Scoop 包管理器安装

# 安装 Scoop
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex
# 安装 Git LFS
scoop install git-lfs
# 验证安装
git lfs version

3.4 WSL 环境安装

在 Windows Subsystem for Linux 中安装方法与 Linux 系统相同，推荐使用对应发行版的包管理器。

四、安装后的初始化配置

无论使用哪种安装方式，完成后都需要执行以下命令启用 Git LFS：

# 全局启用 Git LFS（对所有仓库生效）
git lfs install
# 或仅对当前仓库启用
cd /path/to/your/repo
git lfs install --local

配置检查：通过 git config --global --get filter.lfs.process 验证是否输出 git-lfs filter-process，确认配置成功。

五、常见安装问题解决方案

5.1 "git: 'lfs' is not a git command" 错误

# 检查 Git LFS 是否在 PATH 中
which git-lfs # Linux/macOS
where git-lfs # Windows
# 如未找到，手动添加安装路径到 PATH
export PATH="$PATH:/usr/local/bin" # Linux/macOS

5.2 macOS 安全提示 "无法打开因为无法验证开发者"

# 允许从任何来源安装（仅临时操作）
sudo spctl --master-disable
# 安装完成后恢复安全设置
sudo spctl --master-enable

5.3 Windows 命令提示符无法识别 git-lfs 命令

1. 打开 "控制面板 > 系统 > 高级系统设置 > 环境变量"
2. 在系统变量中找到 Path，点击 "编辑"
3. 添加 Git LFS 安装路径（默认是 C:\Program Files\Git LFS）
4. 重启命令提示符

六、Git LFS 快速使用示例

# 跟踪大型文件类型
git lfs track "*.psd"
git lfs track "*.zip"
git lfs track "*.iso"
# 查看跟踪列表
git lfs track
# 添加跟踪配置到仓库
git add .gitattributes
# 正常提交
git add large-file.psd
git commit -m "Add design assets"
git push origin main

七、全平台安装方法对比表

八、总结

本文介绍了 Git LFS 在三大操作系统上的安装方法，解决了大文件版本控制的首要障碍。建议继续学习 .gitattributes 文件详解与大文件迁移策略。若遇问题，请查阅官方文档或在项目 GitHub 仓库提交 issue 获取支持。