- Node.js >= 14.x
- MongoDB >= 4.x
- npm >= 6.x 或 yarn >= 1.22
- Visual Studio Code
- 建议安装的扩展:
pomdtr.excalidraw-editor(Excalidraw 编辑器)editorconfig.editorconfig(EditorConfig)lokalise.i18n-ally(i18n 支持)esbenp.prettier-vscode(Prettier)dbaeumer.vscode-eslint(ESLint)burkeholland.simple-react-snippets(React 代码片段)prisma.prisma(Prisma 支持)bradlc.vscode-tailwindcss(Tailwind CSS 支持)
- 建议安装的扩展:
这些扩展将帮助你：
- 使用 Excalidraw 进行图表绘制
- 保持一致的代码风格 (EditorConfig)
- 管理国际化内容 (i18n-ally)
- 代码格式化 (Prettier)
- 代码质量检查 (ESLint)
- 快速输入 React 代码片段
- Prisma ORM 支持
- Tailwind CSS 智能提示
建议在打开项目后，VSCode 会自动提示安装这些推荐的扩展，你可以一键安装所有推荐扩展。
- 进入后端目录:
cd backend- 安装依赖:
npm install- 创建环境配置文件:
cp .env.example .env- 配置环境变量:
PORT=3000
MONGODB_URI=mongodb://localhost:27017/ForexTradingPlatformDB
JWT_SECRET=your_jwt_secret_key- 进入前端目录:
cd frontend- 安装依赖:
npm install- 创建环境配置文件:
cp .env.example .env- 配置环境变量:
VITE_API_URL=http://localhost:3000- 数据库配置
- 确保 MongoDB 服务已启动
- 在
.env文件中设置正确的数据库连接字符串
- JWT 配置
- 在
.env文件中设置安全的 JWT 密钥
- API 配置
- 确保
VITE_API_URL指向正确的后端服务地址
- WebSocket 配置
- WebSocket 服务默认使用与 HTTP 相同的端口
- 开发模式:
cd backend
npm run dev- 生产模式:
cd backend
npm start- 开发模式:
cd frontend
npm run dev- 生产模式:
cd frontend
npm run build
npm run preview- 检查 MongoDB 服务是否正在运行
- 验证数据库连接字符串是否正确
- 确保数据库用户有正确的访问权限
- 检查后端服务是否正在运行
- 验证 API 地址配置是否正确
- 确认是否存在跨域问题
- 确保后端 WebSocket 服务正常运行
- 检查防火墙设置
- 验证前端 WebSocket 连接地址配置
- 清除 npm 缓存:
npm cache clean --force - 删除 node_modules 目录后重新安装
- 检查 Node.js 版本是否符合要求
如遇到其他问题，请参考:
- 项目文档
- GitHub Issues
- 技术支持邮箱
注意：本文档仅供参考，具体配置可能需要根据实际部署环境进行调整。