npm scripts 怎么写高级命令？跨平台兼容怎么处理？

Question

仓乃文 · Accepted Answer

npm scripts 写复杂命令时最头疼的是 Windows 和 macOS/Linux 的命令不兼容。比如 rm -rf 在 Windows 不存在，&& 在某些场景下行为不一致。解决方案是用跨平台工具替代系统命令。

跨平台替代方案：
```
| Unix 命令   | Windows 等价   | 跨平台替代包          |
|------------|---------------|---------------------|
| rm -rf     | rmdir /s /q   | rimraf              |
| mkdir -p   | mkdir         | mkdirp              |
| cp -r      | xcopy         | cpy-cli / ncp       |
| export     | set           | cross-env           |
```

package.json 示例：
```json
{
  "scripts": {
    "clean": "rimraf dist coverage .temp",
    "build": "vite build",
    "dev": "vite",
    "preview": "vite preview",
    "lint": "eslint src --ext .ts,.tsx,.vue",
    "test": "vitest run",
    "test:watch": "vitest",
    "deploy": "npm run build && npm run deploy:cdn",
    "deploy:cdn": "cross-env NODE_ENV=production node scripts/deploy.js",
    "release": "npm run test && npm run build && npm publish",
    "prebuild": "npm run clean",
    "postinstall": "husky install"
  },
  "devDependencies": {
    "rimraf": "^5.0.0",
    "cross-env": "^7.0.3",
    "mkdirp": "^3.0.0"
  }
}
```

高级技巧：
```json
{
  "scripts": {
    "build:staging": "vite build --mode staging",
    "build:prod": "vite build --mode production",
    "lint:fix": "eslint src --fix",
    "parallel": "npm-run-all --parallel dev:app dev:mock",
    "serial": "npm-run-all --serial clean build test"
  }
}
```

补充说明：
- pre/post 钩子：prebuild 在 build 前自动执行，postbuild 在 build 后自动执行
- npm-run-all 支持串行和并行执行多个脚本，比 && 更强大
- 复杂脚本（超过 3 行）建议抽到 scripts/ 目录下的 JS 文件中
- cross-env 设置环境变量是必须的，直接 NODE_ENV=production 在 Windows 会报错