Lint

执行：

全量 lint：

npm run lint

支持 TASKS 参数

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

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

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

scripts/lint.mts 源码

import { joinPath, isPathExists, refreshGitIndex } 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_SSG_APPS_NAMES,
  STANDALONE_SSR_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("server", async (payload) => {
  const { progress, taskName } = payload;
  const { promise } = runCommandInChildProcess({
    appName: `${progress.current}/${progress.total}-${taskName}`,
    command: "tsc",
    args: `--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 appNameDisplay = `${progress.current}/${progress.total}-${taskName}`;

    // oxfmt
    {
      const { promise } = runCommandInChildProcess({
        appName: appNameDisplay,
        command: "oxfmt",
        args: `-c ../../.oxfmtrc.json --ignore-path ../../.oxfmtignore .`,
        env: process.env,
        cwd: `./apps/${appName}`,
      });
      const exitCode = await promise;
      if (exitCode) {
        throw new Error(`Task ${taskName} (oxfmt) failed: exitCode=${exitCode}`);
      }
    }

    // prettier
    {
      const { promise } = runCommandInChildProcess({
        appName: appNameDisplay,
        command: "prettier",
        args: `--write --cache --ignore-path ../../.prettierignore-sub .`,
        env: process.env,
        cwd: `./apps/${appName}`,
      });
      const exitCode = await promise;
      if (exitCode) {
        throw new Error(`Task ${taskName} (prettier) failed: exitCode=${exitCode}`);
      }
    }

    // oxlint
    {
      const { promise } = runCommandInChildProcess({
        appName: appNameDisplay,
        command: "oxlint",
        args: `-c .oxlintrc.json --fix --fix-suggestions ./apps/${appName}/`,
        env: process.env,
      });
      const exitCode = await promise;
      if (exitCode) {
        throw new Error(`Task ${taskName} (oxlint) failed: exitCode=${exitCode}`);
      }
    }

    // vue-tsc
    {
      const { promise } = runCommandInChildProcess({
        appName: appNameDisplay,
        command: "vue-tsc",
        args: `--noEmit --project ./tsconfig.json`,
        env: process.env,
        cwd: `./apps/${appName}`,
      });
      const exitCode = await promise;
      if (exitCode) {
        throw new Error(`Task ${taskName} (vue-tsc) failed: exitCode=${exitCode}`);
      }
    }
  });
}

/**
 * 顺序处理所有 SSG APP（静态：Next.js、Nuxt 静态、VitePress 等）
 */
for (const appName of STANDALONE_SSG_APPS_NAMES) {
  addTask(`ssg:${appName}`, async (payload) => {
    const { progress, taskName } = payload;
    const appNameDisplay = `${progress.current}/${progress.total}-${taskName}`;

    // oxfmt
    {
      const { promise } = runCommandInChildProcess({
        appName: appNameDisplay,
        command: "oxfmt",
        args: `-c ../../.oxfmtrc.json --ignore-path ../../.oxfmtignore .`,
        env: process.env,
        cwd: `./apps-home/${appName}`,
      });
      const exitCode = await promise;
      if (exitCode) {
        throw new Error(`Task ${taskName} (oxfmt) failed: exitCode=${exitCode}`);
      }
    }

    // prettier
    {
      const { promise } = runCommandInChildProcess({
        appName: appNameDisplay,
        command: "prettier",
        args: `--write --cache --ignore-path ../../.prettierignore-sub .`,
        env: process.env,
        cwd: `./apps-home/${appName}`,
      });
      const exitCode = await promise;
      if (exitCode) {
        throw new Error(`Task ${taskName} (prettier) failed: exitCode=${exitCode}`);
      }
    }

    // oxlint
    {
      const { promise } = runCommandInChildProcess({
        appName: appNameDisplay,
        command: "oxlint",
        args: `-c .oxlintrc.json --fix --fix-suggestions ./apps-home/${appName}/`,
        env: process.env,
      });
      const exitCode = await promise;
      if (exitCode) {
        throw new Error(`Task ${taskName} (oxlint) failed: exitCode=${exitCode}`);
      }
    }

    // 区分应用类型：Next.js、Nuxt 4 应用、VitePress 2 应用
    const pathApp = joinPath(PATH_APPS_HOME, appName);
    const pathNuxtConfig = joinPath(pathApp, "nuxt.config.ts");
    const pathNextConfig = joinPath(pathApp, "next.config.ts");
    const isNext = await isPathExists(pathNextConfig);
    const isNuxt = await isPathExists(pathNuxtConfig);
    if (isNext) {
      const { promise } = runCommandInChildProcess({
        appName: appNameDisplay,
        command: "tsc",
        args: "--noEmit --project ./tsconfig.json",
        env: process.env,
        cwd: `./apps-home/${appName}`,
      });
      const exitCode = await promise;
      if (exitCode) {
        throw new Error(`Task ${taskName} (next) failed: exitCode=${exitCode}`);
      }
      return;
    }
    if (!isNuxt) {
      // VitePress 项目，执行 ::: 标记格式修复
      const { promise } = runCommandInChildProcess({
        appName: appNameDisplay,
        command: "node",
        args: `./apps-home/${appName}/scripts/lint.mts`,
        env: process.env,
      });
      const exitCode = await promise;
      if (exitCode) {
        throw new Error(`Task ${taskName} (vitepress) failed: exitCode=${exitCode}`);
      }
      return;
    }

    // Nuxt 项目，执行类型检查
    const { promise } = runCommandInChildProcess({
      appName: appNameDisplay,
      command: "cross-env",
      args: `APP_NAME=${appName} nuxt typecheck --cwd=./apps-home/${appName}`,
      env: process.env,
    });
    const exitCode = await promise;
    if (exitCode) {
      throw new Error(`Task ${taskName} (nuxt typecheck) failed: exitCode=${exitCode}`);
    }
  });
}

/**
 * 顺序处理所有 SSR APP（Nuxt SSR，执行类型检查）
 */
for (const appName of STANDALONE_SSR_APPS_NAMES) {
  addTask(`ssr:${appName}`, async (payload) => {
    const { progress, taskName } = payload;
    const appNameDisplay = `${progress.current}/${progress.total}-${taskName}`;

    // oxfmt
    {
      const { promise } = runCommandInChildProcess({
        appName: appNameDisplay,
        command: "oxfmt",
        args: `-c ../../.oxfmtrc.json --ignore-path ../../.oxfmtignore .`,
        env: process.env,
        cwd: `./apps-home/${appName}`,
      });
      const exitCode = await promise;
      if (exitCode) {
        throw new Error(`Task ${taskName} (oxfmt) failed: exitCode=${exitCode}`);
      }
    }

    // prettier
    {
      const { promise } = runCommandInChildProcess({
        appName: appNameDisplay,
        command: "prettier",
        args: `--write --cache --ignore-path ../../.prettierignore-sub .`,
        env: process.env,
        cwd: `./apps-home/${appName}`,
      });
      const exitCode = await promise;
      if (exitCode) {
        throw new Error(`Task ${taskName} (prettier) failed: exitCode=${exitCode}`);
      }
    }

    // oxlint
    {
      const { promise } = runCommandInChildProcess({
        appName: appNameDisplay,
        command: "oxlint",
        args: `-c .oxlintrc.json --fix --fix-suggestions ./apps-home/${appName}/`,
        env: process.env,
      });
      const exitCode = await promise;
      if (exitCode) {
        throw new Error(`Task ${taskName} (oxlint) failed: exitCode=${exitCode}`);
      }
    }

    // Nuxt SSR，执行类型检查
    const { promise } = runCommandInChildProcess({
      appName: appNameDisplay,
      command: "cross-env",
      args: `APP_NAME=${appName} nuxt typecheck --cwd=./apps-home/${appName}`,
      env: process.env,
    });
    const exitCode = await promise;
    if (exitCode) {
      throw new Error(`Task ${taskName} (nuxt typecheck) failed: exitCode=${exitCode}`);
    }
  });
}

/**
 * Android 壳检查：委托 client/android 子项目自身的 lint 流水线
 * （prettier、eslint、markdownlint、tsc、gradlew lint 与 smoke 测试）
 */
addTask("android", async (payload) => {
  const { progress, taskName } = payload;
  const { promise } = runCommandInChildProcess({
    appName: `${progress.current}/${progress.total}-${taskName}`,
    command: "node",
    args: "--run lint",
    env: process.env,
    cwd: "./client/android",
  });
  const exitCode = await promise;
  if (exitCode) {
    throw new Error(`Task ${taskName} failed: exitCode=${exitCode}`);
  }
});

/**
 * Electron 壳检查：委托 client/electron 子项目自身的 lint 流水线
 * （type-check、构建与 node:test）
 */
addTask("electron", async (payload) => {
  const { progress, taskName } = payload;
  const { promise } = runCommandInChildProcess({
    appName: `${progress.current}/${progress.total}-${taskName}`,
    command: "node",
    args: "--run lint",
    env: process.env,
    cwd: "./client/electron",
  });
  const exitCode = await promise;
  if (exitCode) {
    throw new Error(`Task ${taskName} failed: exitCode=${exitCode}`);
  }
});

await runTasksSequentially();

printTaskStatisticsInfo();

// 所有检查通过后刷新 git 索引，清除格式化工具重写造成的假差异
const { hasRealChanges, status } = refreshGitIndex();
if (hasRealChanges) {
  console.log("刷新完成，剩余真实差异：");
  console.log(status);
} else {
  console.log("刷新完成，工作区与索引内容一致，无真实差异。");
}