环境要求
项目概述
邮轮穿舱件管理系统前端页面是基于Vue.js 2.x技术栈构建的后台管理系统，采用现代前端开发工具链和组件化架构。
Node.js版本要求
根据package.json文件分析，项目未明确指定Node.js版本要求，但基于以下依赖版本推断：
- @vue/cli-service: ~5.0.0
- @vue/cli-plugin-babel: ~5.0.0
- @vue/cli-plugin-eslint: ~5.0.0
推荐版本: Node.js 14.x 或更高版本 最低版本: Node.js 12.x
包管理器要求
npm版本要求
- 推荐版本: npm 6.x 或更高版本
- 最低版本: npm 5.6.0
yarn版本要求（可选）
- 推荐版本: yarn 1.22.x 或更高版本
- 兼容版本: yarn 1.x
浏览器兼容性要求
根据package.json中的browserslist配置：
"browserslist": [
"> 1%",
"last 2 versions",
"not dead"
]
具体浏览器支持
| 浏览器类型 | 最低版本 | 推荐版本 |
|---|---|---|
| Chrome | 60+ | 90+ |
| Firefox | 60+ | 88+ |
| Safari | 12+ | 14+ |
| Edge | 79+ | 91+ |
| Opera | 50+ | 76+ |
移动端浏览器支持
- iOS Safari: 12+
- Chrome for Android: 91+
- Samsung Internet: 14+
核心依赖版本要求
运行时依赖
| 依赖包 | 版本要求 | 用途 |
|---|---|---|
| vue | ^2.6.14 | Vue.js核心框架 |
| vue-router | ^3.6.5 | 路由管理 |
| vuex | ^3.6.2 | 状态管理 |
| vuetify | ^2.6.0 | Material Design组件库 |
| axios | ^1.7.5 | HTTP客户端 |
| core-js | ^3.8.3 | JavaScript标准库polyfill |
开发依赖
| 依赖包 | 版本要求 | 用途 |
|---|---|---|
| @vue/cli-service | ~5.0.0 | Vue CLI服务 |
| @vue/cli-plugin-babel | ~5.0.0 | Babel转译插件 |
| @vue/cli-plugin-eslint | ~5.0.0 | ESLint代码检查 |
| sass | ~1.32.0 | CSS预处理器 |
| vue-template-compiler | ^2.6.14 | Vue模板编译 |
开发环境配置要求
内存要求
- 最低: 4GB RAM
- 推荐: 8GB RAM 或更高
磁盘空间
- 项目空间: 至少500MB可用空间
- 依赖缓存: 额外1GB空间用于node_modules
开发工具推荐
- IDE: VS Code, WebStorm
- 浏览器开发工具: Chrome DevTools, Firefox Developer Edition
构建和部署要求
构建环境
- Node.js: 14.x LTS 或更高
- npm: 6.x 或更高
- 构建内存: 至少2GB可用内存
生产环境要求
- Web服务器: Nginx, Apache, 或任何支持SPA的静态文件服务器
- HTTPS: 推荐启用HTTPS
- CDN: 可选，用于静态资源加速
依赖关系架构图
flowchart TD
subgraph CoreDependencies[核心运行时依赖]
A[Vue.js 2.6.14] --> B[Vue Router 3.6.5]
A --> C[Vuex 3.6.2]
A --> D[Vuetify 2.6.0]
B --> E[Axios 1.7.5]
C --> E
D --> F[Core-js 3.8.3]
end
subgraph DevDependencies[开发工具链]
G[Vue CLI 5.0.0] --> H[Babel]
G --> I[ESLint]
G --> J[Sass]
H --> K[Webpack]
I --> L[代码质量检查]
J --> M[样式预处理]
end
CoreDependencies --> G
技术栈兼容性说明
Vue 2.x 生态系统
项目基于Vue 2.x构建，与Vue 3.x不兼容。主要兼容组件包括：
- Vue Router 3.x (与Vue 2.x配套)
- Vuex 3.x (与Vue 2.x配套)
- Vuetify 2.x (Material Design组件库)
构建工具兼容性
Vue CLI 5.x 基于Webpack 5构建，提供现代化的构建体验和优化。
安装和运行说明
环境检查脚本
# 检查Node.js版本
node --version
# 检查npm版本
npm --version
# 检查yarn版本（如使用）
yarn --version
依赖安装
# 使用npm安装
npm install
# 或使用yarn安装
yarn install
开发服务器启动
# 开发模式
npm run serve
# 或使用yarn
yarn serve
故障排除
常见问题
- Node.js版本过低: 升级到Node.js 14.x或更高版本
- 依赖安装失败: 清除npm缓存后重试
npm cache clean --force - 内存不足: 增加Node.js内存限制
export NODE_OPTIONS="--max-old-space-size=4096"
版本冲突解决
如遇到版本冲突，建议使用package-lock.json或yarn.lock确保依赖版本一致性。