Composer依赖Git LFS需确保环境支持：1. 安装并初始化Git LFS；2. 克隆时自动下载LFS文件；3. CI/CD中显式配置LFS；4. 避免将大文件直接纳入包，建议用专用存储；5. 资源异常时检查.gitattributes、执行git lfs pull排查。
Composer本身并不直接处理Git LFS（Large File Storage），它依赖于底层的版本控制系统（如Git）来获取代码。当你在Composer项目中使用了启用了Git LFS的仓库时，需要注意一些关键点，以确保依赖项中的大文件能被正确检出和使用。
Git LFS如何影响Composer依赖
如果你的项目或其某个依赖包使用了Git LFS来存储大文件（如二进制资源、图片、数据库转储等），Composer在通过git clone拉取该仓库时，必须确保LFS文件被正确下载，而不是保留占位符。
默认情况下，Composer会执行标准的git clone操作。如果系统未安装Git LFS或未启用，那么LFS管理的文件将只是文本指针，导致运行时报错或资源缺失。
确保环境支持Git LFS
要在Composer项目中正常使用Git LFS资源，开发和部署环境都必须满足以下条件：
Github Xiaoshu
下载
使用 `gh` CLI 与 GitHub 交互。通过`gh issue`、`gh pr`、`gh run` 和 `gh api` 管理 issue、PR、CI 运行以及高级查询。
-
安装Git LFS：在使用
composer install或update前，确保系统已安装Git LFS并完成初始化（git lfs install）。 -
克隆时自动拉取LFS文件：Git LFS会在
git clone过程中自动下载实际的大文件，前提是LFS已启用。 -
CI/CD环境中配置LFS：在持续集成环境中（如GitHub Actions、GitLab CI），需显式安装Git LFS并运行
git lfs pull，否则可能构建失败。
避免将大文件直接纳入依赖包
虽然技术上可行，但将大文件通过Git LFS存入一个Composer包并不是最佳实践。这会导致：
- 依赖安装变慢，尤其在网络较差时。
- 增加镜像和缓存负担。
- 某些托管平台（如Packagist）不推荐或限制大体积包。
更合理的做法是将大文件托管在专用存储（如CDN、对象存储），并在代码中按需下载，或通过构建脚本引入。
调试LFS相关问题
若发现依赖中的资源文件异常（例如只有几行文本，内容为version https://git-lfs.com/spec/v1），说明LFS文件未正确拉取。可采取以下步骤排查：
- 确认本地运行了
git lfs install。 - 检查仓库根目录是否存在
.gitattributes，且包含类似*.psd filter=lfs的规则。 - 手动执行
git lfs pull尝试恢复文件。 - 查看CI日志是否提示
Git LFS not found。
基本上就这些。Composer不会绕过Git机制去处理LFS，关键在于保障Git环境对LFS的支持完整。只要系统配置妥当，Composer就能正常拉取含LFS文件的依赖。
