用途:在新建 React 项目、配置 Vite、设置 TypeScript 或建立项目规范时使用,避免常见搭建错误。
主要能力:提供项目创建步骤(React 18 与 React 19)、推荐目录结构、TypeScript 配置、Vite 配置、ESLint 扁平配置、环境变量规则、package.json 脚本与 .gitignore 模板,并附决策树与参考链接。
必要用法:新建项目使用 npm create vite@latest my-app -- --template react-ts,随后 cd my-app、npm install、npm run dev。React 19 需额外安装 react@19 react-dom@19 与 @types/react@19 @types/node。路径别名需同时在 tsconfig.app.json 和 vite.config.ts 配置。环境变量仅 VITE_ 前缀会暴露给客户端,并在 env.d.ts 声明类型。
限制与警告:不要使用 Create React App;不要提交 .env.local 等本地密钥文件;tsconfig 必须启用 strict: true;Vite 默认不做类型检查,需单独添加 type-check 脚本;ESLint 使用扁平配置。
适用场景:React + Vite + TypeScript 新项目初始化与规范落地。其他细节暂未提供。