项目结构与依赖安装
该项目分为前端和后端两部分,前端代码位于项目根目录,后端代码位于news-crawler文件夹中。运行项目前需确保本机已安装Node.js(建议版本18以上)和npm。项目不包含node_modules目录,需手动安装依赖。

在项目根目录执行以下命令安装前端依赖(如Vue、Vite、Concurrently等):
bash
npm install
进入news-crawler目录执行以下命令安装后端依赖(如Express、Prisma、Axios等):
bash
npm install
安装完成后会自动执行prisma generate。若希望简化操作,可直接在根目录运行以下命令一次性安装前后端依赖:
bash
npm run install:all
环境配置与数据库初始化
将news-crawler目录下的.env.example文件复制为.env,本地开发通常无需修改其内容。随后在news-crawler目录执行以下命令初始化数据库表结构:
bash
npm run db:push

启动开发服务
返回项目根目录,执行以下命令同时启动前后端服务:
bash
npm run dev:all
- 前端服务默认运行在
http://localhost:5173 - 后端服务默认运行在
http://localhost:3000
访问前端页面时,可使用以下测试账号登录:
- 用户名:
demo - 密码:
123456
若需单独启动前端或后端服务:
bash
npm run dev # 仅启动前端
npm run dev:backend # 仅启动后端
项目构建与生产部署
执行以下命令生成生产环境构建产物(输出至dist目录):
bash
npm run build
正式运行后端服务需进入news-crawler目录执行:
bash
npm start
常见问题排查
- 接口返回404:通常为后端服务未正常启动,检查后端进程是否运行。
- 数据库报错 :尝试重新执行
npm run db:push命令。 - 依赖重装 :需先停止所有运行中的服务,删除根目录和
news-crawler下的node_modules文件夹,再重新执行依赖安装步骤。