You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

111 lines
2.3 KiB

# 🚀 GoFaster 增强版开发环境
## 📋 问题解决
本增强版开发环境解决了以下问题:
### 1. **中文乱码问题**
- ✅ 设置 UTF-8 编码
- ✅ 配置 PowerShell 编码
- ✅ 设置环境变量 LANG 和 LC_ALL
### 2. **日志信息少的问题**
- ✅ 启用详细日志级别 (INFO)
- ✅ 配置 Webpack 统计信息
- ✅ 添加构建进度条
- ✅ 增强错误和警告显示
## 🛠 使用方法
### **方法 1: PowerShell 脚本(推荐)**
```powershell
# 标准模式
npm run dev:enhanced
# 调试模式
npm run dev:enhanced -Debug
# 监听模式
npm run dev:enhanced -Watch
```
### **方法 2: 批处理脚本**
```cmd
# 标准模式
npm run dev:enhanced-bat
```
### **方法 3: 直接命令**
```bash
# 标准模式
npm run dev
# 调试模式
npm run dev:debug
# 监听模式
npm run dev:watch
```
## 🔧 新增功能
### **1. 编码设置**
- 自动设置 UTF-8 编码
- 配置环境变量 LANG 和 LC_ALL
- 设置 Node.js 选项
### **2. 日志增强**
- 详细构建信息
- 进度条显示
- 错误详情展示
- 警告信息过滤
### **3. 依赖管理**
- 自动检查依赖
- 自动安装 cross-env
- 内存优化设置
### **4. 错误处理**
- 友好的错误提示
- 故障排除建议
- 状态码检查
## 📁 文件说明
| 文件 | 说明 |
|------|------|
| `dev-enhanced.ps1` | PowerShell 增强脚本 |
| `dev-enhanced.bat` | 批处理增强脚本 |
| `.npmrc` | npm 配置文件 |
| `vue.config.js` | Vue CLI 增强配置 |
## 🚨 故障排除
### **中文仍然乱码**
1. 确保使用 PowerShell 或 CMD
2. 检查系统区域设置
3. 使用 `npm run dev:enhanced` 脚本
### **日志信息仍然很少**
1. 使用 `npm run dev:debug` 命令
2. 检查 `vue.config.js` 配置
3. 确保 `cross-env` 已安装
### **构建失败**
1. 清除 `node_modules` 并重新安装
2. 检查 Node.js 版本 (推荐 v16+)
3. 查看详细错误日志
## 💡 最佳实践
1. **推荐使用 PowerShell 脚本**:更好的编码支持和错误处理
2. **开发时使用监听模式**:自动重新构建
3. **调试时使用调试模式**:获取详细信息
4. **定期清理缓存**:避免构建问题
## 🔄 更新日志
- **v1.0.0**: 基础增强功能
- **v1.1.0**: 添加调试和监听模式
- **v1.2.0**: 优化错误处理和用户提示