QUICKSTART.md 2.3 KB

快速开始指南

本指南帮助您在 5 分钟内快速启动项目。

🚀 快速启动

第一步:克隆项目

git clone https://your-repo-url.git
cd interview_web

第二步:安装依赖

npm install

第三步:启动项目

npm run dev

访问 http://localhost:8080

📋 前置条件检查

确保您已安装:

  • ✅ Node.js >= 16.0.0
  • ✅ npm >= 7.0.0

检查版本:

node -v
npm -v

⚙️ 快速配置

1. 配置后端 API 地址

创建或编辑 .env.development 文件:

VITE_API_URL=http://localhost:8000
VITE_PUBLIC_PATH=/
VITE_PORT=8080

2. 登录系统

默认账号:superadmin
默认密码:admin123456

🎯 常用命令

开发环境

npm run dev          # 启动开发服务器

生产构建

npm run build        # 构建生产版本
npm run build:local  # 本地生产构建

代码检查

npm run lint-fix     # ESLint 自动修复

📖 下一步

学习项目结构

开始开发

部署上线

🆘 遇到问题?

常见问题

  1. 端口被占用

    # 修改 vite.config.ts 中的端口号
    server: { port: 3000 }
    
  2. 依赖安装失败

    # 清除缓存后重新安装
    npm cache clean --force
    npm install
    
  3. API 请求失败

    • 检查后端服务是否启动
    • 检查 .env.development 配置

获取帮助

  • 📖 查看项目文档
  • 🐛 提交 Issue
  • 💬 联系团队

✅ 验证安装

运行以下命令验证环境:

# 检查 Node.js 版本
node -v

# 检查依赖安装
ls node_modules

# 启动开发服务器
npm run dev

# 访问 http://localhost:8080
# 应该能看到登录页面

🎉 完成!

现在您已经成功启动了项目,可以开始开发了!

查看项目文档了解更多: