如何在GitHub CI中集成Git LFS，解决测试失败问题

你的问题根源在于：默认情况下actions/checkout@v2只会拉取Git仓库中的普通文件和LFS指针文件，不会自动下载Git LFS存储的实际文件，导致测试时无法访问这些依赖文件，进而触发测试失败。

以下是修改后的完整CI配置，核心是在代码拉取步骤中启用Git LFS支持：

name: Node.js CI

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  build:
    strategy:
      matrix:
        platform: [ubuntu-latest, macos-latest, windows-latest]
        node-version: [12.x, 14.x, 16.x]
        
    runs-on: ${{ matrix.platform }}

    steps:
    - uses: actions/checkout@v2
      with:
        lfs: true  # 启用Git LFS拉取
    - name: Use Node.js ${{ matrix.node-version }}
      uses: actions/setup-node@v2
      with:
        node-version: ${{ matrix.node-version }}
        cache: 'npm'
    - name: Upgrade NPM
      run: npm install -g npm
    - run: npm ci
    - run: npm test

关键修改说明 #

• 在actions/checkout@v2步骤中添加lfs: true参数，GitHub Actions会自动处理Git LFS的文件拉取，无需额外安装LFS客户端（GitHub托管的Runner默认已预装Git LFS）。
• 如果使用的是更低版本的actions/checkout（比如v1），则需要手动添加拉取LFS文件的步骤：

  - uses: actions/checkout@v1
  - name: Pull LFS files
    run: git lfs pull
  

额外注意事项 #

• 若使用自托管Runner，需要确保Runner环境已安装Git LFS，否则需在CI步骤中先执行安装命令（比如Ubuntu上sudo apt-get install git-lfs）。
• 若LFS文件体积较大，可考虑配合GitHub Actions的缓存机制减少重复下载时间，但这属于优化项，不影响基础功能。

内容的提问来源于stack exchange，提问作者João Pimentel Ferreira