Review and maintain the curren…

# .github/actions/setup-node 升级与校验修复方案

一、原 action.yml（问题版）

```yaml

name: 'Setup Node'

description: '复用 Node 环境安装 action'

runs:

using: 'composite'

steps:

• uses: actions/setup-node@v4

with:

node-version: 18 # ❌ 硬编码旧版本

cache: 'npm'

• run: npm ci

shell: bash

```

问题清单：① node 18 已于 2025-04 结束维护；② 无 inputs 定义，外部传参静默失效；③ 未声明 inputs: 导致复用时无法校验。

二、升级后的 action.yml（成品）

```yaml

name: 'Setup Node'

description: 'Reusable Node setup with cache'

inputs:

node-version:

description: 'Node.js version to install'

required: false

default: '20'

cache:

description: 'Package manager cache (npm/yarn/pnpm)'

required: false

default: 'npm'

working-directory:

description: 'Directory to run npm ci'

required: false

default: '.'

runs:

using: 'composite'

steps:

• uses: actions/setup-node@v4

with:

node-version: ${{ inputs.node-version }}

cache: ${{ inputs.cache }}

• name: Validate node version

shell: bash

run: |

major=$(node -p "process.versions.node.split('.')[0]")

if [ "$major" -lt 18 ]; then

echo "::error::Node >= 18 required, got $(node -v)"

exit 1

fi

• run: npm ci

shell: bash

working-directory: ${{ inputs.working-directory }}

```

三、调用方更新（仓库内 3 处 workflow 同步改）

```yaml

• uses: ./.github/actions/setup-node

with:

node-version: '20' # 原 '18' 全部替换

```

四、修复要点说明

1. 版本升级：默认值 18→20，用 inputs.node-version 动态引用，调用方可覆盖；

2. inputs 校验：显式声明 3 个 input，含 required/`