# 脚手架核心预装一览

> 本文介绍 ArenaPro CLI 脚手架在新项目中**默认预装**的一些依赖，它们主要用于开发体验、代码质量和构建流程。
>
> 这些依赖都已经在脚手架里帮你配好了，一般情况下可以直接用，无需自己一项项从零搭。

## 1. 开发与构建相关

- **`vite`**

  - 作为项目的前端构建工具，负责 `dev` / `build`。
  - 提供快速热更新（HMR）和生产构建能力，是整个脚手架的“发动机”。

- **`vite-tsconfig-paths`**

  - 一个让 Vite 识别 `tsconfig.json` 中 `paths` 路径别名的插件。
  - 你可以在脚本里使用类似 `@/src/...` 这类别名导入，而不用再在 `vite.config.ts` 里手动重复配置一长串相对路径。

- **`vite-plugin-arenapro-script`**

  - 专门为 ArenaPro 集成的 Vite 插件。
  - 负责在构建时实现脚本自动上传至神岛地图中。

- **`vite-plugin-checker`**

  - 一个在 Vite 中跑类型检查 / Lint 的插件。
  - 开启后可以构建前看到 TypeScript 错误或 ESLint 报错。

- **`typescript`**

  - TypeScript 编译器本体。
  - 脚手架默认使用 TS 开发脚本，所以会预装一个版本并在 tsconfig 中做好基础配置。

- **`npm-run-all`**

  - 一个帮助你**串行 / 并行运行多个 npm scripts** 的小工具。
  - 在脚手架的 `package.json` 里常用于：
    - 一条命令同时启动多个任务。
  - 让复杂一点的脚本编排更可读，而不是堆很多 `&&`。

- **`cross-env`**
  - 用于**跨平台设置环境变量**的工具。
  - 解决 Windows / macOS / Linux 在 `NODE_ENV=xxx` 这类写法上的差异问题。

## 2. 代码质量与规范相关

- **`eslint`**

  - 用于代码风格和潜在问题检查。
  - 脚手架会提供基础的 ESLint 配置，帮助你在开发阶段就发现一些常见错误（未使用变量、意外的 any、危险写法等）。

- **`typescript-eslint`**

  - 让 ESLint 能理解 TypeScript 语法和类型信息的一套工具链。
  - 搭配 `eslint` 一起使用，可以在 TS 项目中获得更准确的静态检查。

- **`prettier`**

  - 代码格式化工具，用于统一团队代码风格。
  - 脚手架会预置基础配置，让你可以通过编辑器快速统一格式，避免「谁格式化了整个文件」这种 diff 污染。

- **`husky`**
  - Git hooks 管理工具。
  - 常用于在 `git commit` / `git push` 前自动执行检查（如 lint、typecheck），避免明显错误进入仓库。
  - 脚手架会预留好接入点，你可以按团队需要决定是否开启、具体要在钩子里跑哪些命令。

## 3. 业务辅助相关

- **`i18next`**
  - 一个常用的国际化（i18n）库。
  - 预装它是为了方便你在脚本中管理多语言文本（界面文案、提示信息等）。
  - 如果你的地图暂时不需要做多语言，可以先不使用；将来要做国际化时，直接在项目里引入即可。
