GitHub Actions YAML语法错误：自动发布npm包失败求助

关键遗漏：缺少代码拉取步骤 #

你的Workflow配置里没有添加actions/checkout步骤，GitHub Actions runner默认不会自动拉取仓库代码，后续的npm version、git push等操作都无法基于仓库代码执行，这是核心问题之一。

常见问题及修复方案 #

1. 补充代码拉取步骤

在所有步骤最开头添加：

- uses: actions/checkout@v4
  with:
    fetch-depth: 0 # 拉取完整历史，确保npm version能正确识别标签

2. Git推送权限不足

GitHub Actions默认的GITHUB_TOKEN没有仓库写入权限，会导致git push失败。解决方法：

• 在job级别添加权限配置：

jobs:
  publish:
    runs-on: ubuntu-latest
    permissions:
      contents: write # 赋予仓库内容写入权限
    steps:
      # 后续步骤...

• 若默认token仍无法推送，改用个人访问令牌（PAT）：生成带repo权限的PAT并添加到仓库Secrets（命名为GH_PAT），修改push命令：

git push https://${{ secrets.GH_PAT }}@github.com/你的用户名/你的仓库名.git && git push --tags https://${{ secrets.GH_PAT }}@github.com/你的用户名/你的仓库名.git

3. 确保NPM令牌权限有效

• 登录npm官网，确认NPM_PUBLISH_TOKEN是自动化发布令牌，且拥有对应npm包的publish权限；
• 检查令牌是否过期。

4. 可选：版本更新后同步依赖

执行npm version patch后，建议补充依赖安装步骤，避免发布时出现版本不一致问题：

npm install

修正后的完整Workflow示例 #

name: Auto Publish to npm
on:
  push:
    branches: [ main ] # 可根据需求调整触发分支

jobs:
  publish:
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - uses: actions/setup-node@v3
        with:
          node-version: '16.x'
          registry-url: 'https://registry.npmjs.org'

      - name: Bump version & push
        run: |
          git config --global user.name '你的用户名'
          git config --global user.email '你的邮箱'
          npm version patch
          npm install
          git push && git push --tags

      - run: npm publish
        env:
          NODE_AUTH_TOKEN: ${{ secrets.NPM_PUBLISH_TOKEN }}

内容的提问来源于stack exchange，提问作者Naeem Navjivan