admin_core/demo-project/启动前必读.md

⚠️ 启动前必读

📦 第一步：安装依赖

在 demo-project 目录下运行：

npm install

如果遇到依赖缺失错误，运行：

npm install @vue/babel-preset-jsx brace vue2-ace-editor --save

🚀 第二步：启动项目

方式一：使用脚本（推荐）

Windows 用户：

双击 start.bat

Linux/Mac 用户：

./start.sh

方式二：手动启动

npm run dev

✅ 验证安装

运行以下命令检查依赖是否完整：

npm list --depth=0

应该看到以下关键依赖：

• ✅ @vue/babel-preset-jsx
• ✅ brace
• ✅ vue2-ace-editor
• ✅ vue
• ✅ vuex
• ✅ vue-router
• ✅ view-design

🔍 常见问题

问题1：依赖缺失

症状：看到 "UNMET DEPENDENCY" 错误

解决：

# 删除依赖重装
rm -rf node_modules
rm package-lock.json
npm install

问题2：端口被占用

症状：8080 端口已被占用

解决：修改 webpack.config.js 中的端口

devServer: {
  port: 8081  // 改成其他端口
}

问题3：路径找不到

症状：无法找到 ../../src/index.js

解决：确保项目结构正确

f:\项目\前端框架项目\
├── src\                # ← 框架源码
│   └── index.js       # ← 框架入口
└── demo-project\      # ← Demo 项目
    └── src\
        └── main.js    # ← 引用 ../../src/index.js

📝 项目说明

本项目直接使用框架源码（不是打包文件），好处：

• ✅ 实时调试
• ✅ 热更新
• ✅ 方便开发

🎯 访问地址

启动后访问：http://localhost:8080

可用页面：

• /login - 登录页面
• /home - 主页
• /business/product - 产品列表示例

---

如有问题，请查看：

• CHANGELOG.md - 更新日志
• README.md - 完整说明
• 如何启动.txt - 快速指南