git clone下来的文件不完整（仓库中部分文件是用Git LFS上传的）

为什么有些文件没有下载完整？

由于github仓库中的有些大文件是使用Git LFS上传的。但是在执行

git clone

时，Git 默认只下载文件的 LFS 指针，而不是大文件的实际内容。这些指针文件是占位符，指向 LFS 服务器上存储的实际文件。

如何解决？

1、确保本地安装了 Git LFS：如果本地没有安装 Git LFS，LFS 文件将无法正确下载。使用以下命令检查 Git LFS 是否已安装

git lfs install

# 若已经安装lfs，则输出以下内容
Git LFS initialized.

# 没有安装lfs，则输出以下内容
git: 'lfs' is not a git command. See 'git --help'.

The most similar command is
        log

2、如果尚未安装，可以使用以下命令安装：

若为Ubuntu系统

# Ubuntu系统
sudo apt-get install git-lfs

# Centos系统，如果使用 yum安装
sudo yum install git-lfs

# macOS
brew install git-lfs

3、克隆仓库并下载 Git LFS 文件：

# 示例，此处替换为目标仓库地址
git clone https://github.com/user/repo.git

克隆仓库后，可以运行以下命令来下载 Git LFS 文件。该命令从 Git LFS 服务器拉取通过 Git LFS 管理的实际大文件，并将这些文件从占位符替换为真实文件。即执行该命令后会下载所有由 LFS 管理的文件，确保大文件下载完整。

git lfs pull

4、使用

--recurse-submodules

参数（针对仓库包含子模块的情况，不包含则不需执行）：

如果仓库中包含子模块，并且子模块中的某些文件是通过 Git LFS 管理的，那么在克隆时应该使用

--recurse-submodules

参数：

git clone --recurse-submodules https://github.com/user/repo.git

5、手动检查下载是否完整：

git lfs ls-files

可以通过该指令手动检查哪些文件是通过 Git LFS 管理的，执行后将列出当前仓库中由 LFS 管理的所有文件。

总结

• Git 克隆操作已经成功完成了普通对象的下载。
• Git LFS 管理的大文件可能尚未下载，需要通过 git lfs pull 命令下载完整的 LFS 文件。
• 确保本地正确安装了 Git LFS，并在克隆后运行相应的命令来拉取大文件。