如何管理跨平台Node项目的复杂Yarn构建脚本？

问题背景 #

我在Node项目的package.json中配置了如下构建脚本：

{
  "scripts": {
    "build": "SOME_VAR=$(ts-node ./scripts/build/hash-check.ts) && if [ \"$SOME_VAR\" = \"true\" ]; then yarn script-1 && yarn script-2 && yarn script-3 && yarn script-4 && yarn script-5; fi",
  }
}

hash-check.ts的结尾代码为：

console.log(isBooleanVar.toString());

该脚本在macOS和Linux环境下运行正常，但在Windows（win32 x64）环境中执行时会报错：

"$SOME_VAR" was unexpected at this time.
error Command failed with exit code 1.

报错原因是bash的$variable语法与CMD的%variable%语法不兼容。我已将脚本改写为批处理格式，但想了解：对于需跨多平台维护的Node项目，应如何管理这类复杂构建脚本？

实用解决方案 #

1. 用Node脚本替代Shell/批处理逻辑 #

将所有判断、执行逻辑迁移到Node/TS脚本中，彻底绕开平台语法差异，这是维护成本最低的方案：

• 新建scripts/build/main.ts：

import { execSync } from 'child_process';

// 执行hash-check脚本并获取结果（去除首尾空白）
const checkResult = execSync('ts-node ./scripts/build/hash-check.ts', { encoding: 'utf8' }).trim();

if (checkResult === 'true') {
  // 依次执行子脚本，stdio: 'inherit'确保输出同步到终端
  execSync('yarn script-1', { stdio: 'inherit' });
  execSync('yarn script-2', { stdio: 'inherit' });
  execSync('yarn script-3', { stdio: 'inherit' });
  execSync('yarn script-4', { stdio: 'inherit' });
  execSync('yarn script-5', { stdio: 'inherit' });
}

• 简化package.json中的构建脚本：

{
  "scripts": {
    "build": "ts-node ./scripts/build/main.ts"
  }
}

2. 使用跨平台工具统一Shell语法 #

借助cross-var和cross-env工具，自动适配不同平台的变量引用和环境变量传递，无需重构现有Shell逻辑：

• 安装依赖：

yarn add cross-env cross-var -D

• 修改package.json脚本：

{
  "scripts": {
    "build": "cross-var SOME_VAR=$(ts-node ./scripts/build/hash-check.ts) && cross-var if [ \"$SOME_VAR\" = \"true\" ]; then yarn script-1 && yarn script-2 && yarn script-3 && yarn script-4 && yarn script-5; fi"
  }
}

3. 分平台编写专属脚本 #

针对Unix（macOS/Linux）和Windows分别编写脚本，通过包管理工具的平台自动识别机制执行对应逻辑：

• 安装npm-run-all用于批量执行脚本：

yarn add npm-run-all -D

• 配置多平台脚本：

{
  "scripts": {
    "build:unix": "SOME_VAR=$(ts-node ./scripts/build/hash-check.ts) && if [ \"$SOME_VAR\" = \"true\" ]; then yarn script-1 && yarn script-2 && yarn script-3 && yarn script-4 && yarn script-5; fi",
    "build:win": "for /f %%i in ('ts-node ./scripts/build/hash-check.ts') do set SOME_VAR=%%i && if \"!SOME_VAR!\"==\"true\" (yarn script-1 && yarn script-2 && yarn script-3 && yarn script-4 && yarn script-5)",
    "build": "run-s build:*"
  }
}

Yarn/npm会自动识别当前操作系统，执行匹配的build:unix或build:win脚本，适合无法用Node脚本替代的复杂Shell场景。

4. 独立Shell脚本+跨平台执行器 #

将Shell逻辑写入单独的.sh文件，使用shx在Windows上模拟bash环境执行：

• 新建scripts/build.sh：

SOME_VAR=$(ts-node ./scripts/build/hash-check.ts)
if [ "$SOME_VAR" = "true" ]; then
  yarn script-1
  yarn script-2
  yarn script-3
  yarn script-4
  yarn script-5
fi

• 安装shx：

yarn add shx -D

• 更新package.json脚本：

{
  "scripts": {
    "build": "shx ./scripts/build.sh"
  }
}

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