Lint

执行：

全量 lint：

npm run lint

支持 TASKS 参数

该命令支持通过 TASKS 来指定具体执行哪些任务（不传的话默认执行全部任务）。

该参数支持白名单和黑名单模式，并且支持 * 通配符。注意，白名单和黑名单模式不可混用，以避免歧义。

# 白名单：执行所有 spa: 开头的任务
cross-env TASKS=spa:* npm run <example-command>
# 白名单：混合精确匹配和通配符
cross-env TASKS=cleanAllBuildFiles,ssg:* npm run <example-command>
# 黑名单：排除所有 spa: 开头的任务
cross-env TASKS=-spa:* npm run <example-command>

scripts/lint.mts 源码

import { joinPath, isPathExists } from "nsuite";
import { runCommandInChildProcess } from "#scripts/utils/child-process";
import { useTask } from "#scripts/utils/use-task";
import { checkEnvFilesConsistency } from "#scripts/utils/check-env";
import { PATH_APPS_HOME, STANDALONE_APPS_NAMES, SUB_APPS_NAMES } from "#utils/ConstantUtils";

const { killAllChildProcessWhenSuitable, addTask, runTasksSequentially, printTaskStatisticsInfo } =
  useTask({ allowTasks: process.env.TASKS || "" });

killAllChildProcessWhenSuitable();

addTask("check:env", async () => {
  await checkEnvFilesConsistency();
});

addTask("oxfmt", async (payload) => {
  const { progress, taskName } = payload;
  const { promise } = runCommandInChildProcess({
    appName: `${progress.current}/${progress.total}-${taskName}`,
    command: "npx",
    args: `oxfmt -c .oxfmtrc.json --ignore-path .oxfmtignore`,
    env: process.env,
  });
  const exitCode = await promise;
  if (exitCode) {
    throw new Error(`Task ${taskName} failed: exitCode=${exitCode}`);
  }
});

addTask("prettier", async (payload) => {
  const { progress, taskName } = payload;
  const { promise } = runCommandInChildProcess({
    appName: `${progress.current}/${progress.total}-${taskName}`,
    command: "npx",
    args: `prettier --write ./`,
    env: process.env,
  });
  const exitCode = await promise;
  if (exitCode) {
    throw new Error(`Task ${taskName} failed: exitCode=${exitCode}`);
  }
});

addTask("oxlint", async (payload) => {
  const { progress, taskName } = payload;
  const { promise } = runCommandInChildProcess({
    appName: `${progress.current}/${progress.total}-${taskName}`,
    command: "npx",
    args: `oxlint --type-aware --fix --fix-suggestions`,
    env: process.env,
  });
  const exitCode = await promise;
  if (exitCode) {
    throw new Error(`Task ${taskName} failed: exitCode=${exitCode}`);
  }
});

addTask("server", async (payload) => {
  const { progress, taskName } = payload;
  const { promise } = runCommandInChildProcess({
    appName: `${progress.current}/${progress.total}-${taskName}`,
    command: "npx",
    args: `tsc --noEmit --project ./tsconfig.json`,
    env: process.env,
  });
  const exitCode = await promise;
  if (exitCode) {
    throw new Error(`Task ${taskName} failed: exitCode=${exitCode}`);
  }
});

for (const appName of SUB_APPS_NAMES) {
  addTask(`spa:${appName}`, async (payload) => {
    const { progress, taskName } = payload;
    const { promise } = runCommandInChildProcess({
      appName: `${progress.current}/${progress.total}-${taskName}`,
      command: "npx",
      args: `vue-tsc --noEmit --project ./apps/${appName}/tsconfig.json`,
      env: process.env,
    });
    const exitCode = await promise;
    if (exitCode) {
      throw new Error(`Task ${taskName} failed: exitCode=${exitCode}`);
    }
  });
}

/**
 * 顺序构建所有 SSG APP
 */
for (const appName of STANDALONE_APPS_NAMES) {
  // 区分应用类型：Nuxt 4 应用、VitePress 2 应用
  const pathApp = joinPath(PATH_APPS_HOME, appName);
  const pathNuxtConfig = joinPath(pathApp, "nuxt.config.ts");
  const isNuxt = await isPathExists(pathNuxtConfig);
  if (!isNuxt) {
    continue;
  }
  addTask(`ssg:${appName}`, async (payload) => {
    const { progress, taskName } = payload;
    const { promise } = runCommandInChildProcess({
      appName: `${progress.current}/${progress.total}-${taskName}`,
      command: "npx",
      args: `cross-env APP_NAME=${appName} nuxt typecheck --cwd=./apps-home/${appName}`,
      env: process.env,
    });
    const exitCode = await promise;
    if (exitCode) {
      throw new Error(`Task ${taskName} failed: exitCode=${exitCode}`);
    }
  });
}

await runTasksSequentially();

printTaskStatisticsInfo();