环境要求
运行环境
| 工具 | 版本要求 | 说明 |
|---|---|---|
| Node.js | >= 24.18.0 | guava-ui 引擎要求 >=24.18.0 |
| pnpm | >= 11.9.0 | 项目使用 pnpm 管理依赖 |
检查版本：
bash
node -v
pnpm -v安装 Node.js
使用 nvm 管理 Node 版本：
bash
nvm install 24.18.0
nvm use 24.18.0安装 pnpm
bash
npm install -g pnpm@11.9.0推荐编辑器
推荐插件
Vue (Official) Vue官方插件，提供 Vue 相关的语法高亮、格式化、代码提示等功能。UnoCSSUnoCSS 插件，提供 Vue 3 中的 CSS 代码提示、格式化等功能。Prettier - Code formatter代码格式化插件，提供一致的代码格式。koroFileHeader文件头插件，自动生成文件头注释。indent-rainbow缩进插件，提供代码缩进可视化提示。i18n Ally国际化助手插件，提供 Vue 3 中的 i18n 功能。ESLint代码格式化插件，提供一致的代码格式。Chinese (Simplified)中文插件，提供中文代码提示。Error Lens错误提示插件，提供代码错误提示。Beautify css/sass/scss/less样式代码格式化插件，提供一致的样式代码格式。
项目目录结构
guava-web/
├── build/ # 构建入口
├── public/ # 静态资源（favicon、logo）
├── src/
│ ├── api/ # API 接口（admin / login / svcProduct）
│ ├── assets/ # 字体、图片、SVG
│ ├── components/ # 全局组件（GvAxios、GvEcharts、GvUpload 等）
│ ├── config/ # 应用配置
│ ├── const/ # 常量
│ ├── hook/ # 组合式函数（service / web）
│ ├── layout/ # 布局组件
│ ├── locales/ # 国际化（中/英）
│ ├── pages/ # 生成配置文档
│ ├── plugins/ # 插件（elementPlus、i18n、svgIcon、unocss）
│ ├── router/ # 路由配置
│ ├── store/ # Pinia 状态管理
│ ├── styles/ # 全局样式
│ ├── utils/ # 工具函数
│ ├── views/ # 页面视图
│ │ ├── dashboard/ # 仪表盘
│ │ ├── demo/ # 示例组件
│ │ ├── features/ # 401/404/重定向
│ │ ├── iconsMng/ # 图标管理
│ │ ├── login/ # 登录
│ │ ├── profile/ # 个人中心
│ │ ├── svcProduct/svcLead/ # 线索业务（含 helper、类型）
│ │ └── sysMng/ # 系统管理（用户/角色/部门/字典/商机等）
│ ├── App.vue
│ ├── main.ts
│ └── settings.ts
├── types/ # 全局类型声明
├── 配置文件 # vite / tsconfig / eslint / prettier / uno 等
└── README / LICENSE / CHANGELOG环境变量
| 环境变量 | 说明 |
|---|---|
| .env | 项目配置文件 |
| .env.dev | 开发环境配置文件 |
| .env.prod | 生产环境配置文件 |
下一步
环境就绪后，参见 本地开发 启动文档站。