资源描述
advanced-React-cli 是一款面向 React 开发者的增强型命令行工具，用于快速、安全地安装和管理项目依赖（如 UI 库、状态管理、路由等），避免手动配置兼容性问题。适用于中大型 React 项目初始化、依赖升级及团队标准化开发流程，支持交互式选择、版本智能匹配与 peer dependency 自动解析，显著提升开发效率与工程一致性。
详细内容
## 工具定位与核心价值
`advanced-React-cli` 是一个专为 React 生态设计的增强型 CLI 工具，旨在解决 `npm install` 或 `yarn add` 在复杂依赖场景下的痛点——如版本冲突、peer dependency 缺失、包适配性不明确等问题。它不替代 `create-react-app` 或 `Vite` 等脚手架，而是在项目已存在基础上，提供**语义化、上下文感知的依赖集成能力**，帮助开发者精准引入经验证兼容的 React 相关包（如 `@mui/material`、`zustand`、`react-router-dom@6` 等），并自动处理 TypeScript 类型声明、Babel/ESLint 配置建议及必要插件注册。
## 主要功能列表
- ✅ **交互式依赖安装**：通过命令行菜单引导，按类别（UI、状态、路由、表单、测试等）筛选并安装适配当前 React 版本的主流库；
- ✅ **智能版本匹配**：基于项目 `react` 和 `react-dom` 版本，自动推荐兼容的包版本（如 React 18+ 推荐 `react-router-dom@6.22+`）；
- ✅ **Peer Dependency 检查与修复**：安装前扫描缺失或不匹配的 peer deps，并提供一键安装建议；
- ✅ **配置辅助生成**：对需额外配置的包（如 `@emotion/react`），输出最小可用代码片段及配置要点；
- ✅ **离线帮助与文档链接**：内置常用包的简明使用提示，并关联官方文档 URL（如 `https://reactrouter.com/web/guides/quick-start`）。
## 典型使用场景
- 新增状态管理方案时，快速集成 `zustand` 或 `jotai` 并规避 `react` 版本不兼容报错；
- 升级 `react-router` 到 v6 后，安全添加 `@remix-run/router` 及配套 hooks；
- 团队统一规范 UI 库选型（如 MUI vs Ant Design），通过 CLI 标准化安装流程与基础主题配置；
- 在 TypeScript + React 项目中，确保 `@types/*` 包与运行时包版本严格对齐。
## 上手步骤与操作要点
1. **安装**（全局或本地）：
```bash
npm install -g advanced-react-cli
# 或仅当前项目：npx advanced-react-cli
```
2. **运行 CLI**：
```bash
advanced-react-cli add
# 或指定包名快速安装：advanced-react-cli add @mui/material
```
3. **交互操作**：
- 选择目标依赖类型（如「UI Components」→ 「Material UI」）；
- 确认当前 `react` 版本（CLI 自动读取 `package.json`）；
- 查看推荐版本、所需 peer deps 及影响说明；
- 确认后执行 `npm install` 并输出后续配置提示。
> ⚠️ 注意：该工具不修改 `package.json` 以外的文件，所有配置建议均以只读提示形式呈现，确保零侵入性。详细用法见官网文档：[https://advanced-React-cli.netlify.com/](https://advanced-React-cli.netlify.com/)