多端前端PC 用户端
快速开始
环境要求
| 工具 | 版本 |
|---|---|
| Node.js | >= 18.18.0 |
| npm | >= 8.9.0 |
| 后端 | 已启动，默认 http://127.0.0.1:8086 |
安装与启动
cd plus-c
npm install
npm run dev默认访问 http://localhost:4230。开发代理同样把 /dev-api 转发到 127.0.0.1:8086：
proxy: {
'/dev-api': {
target: 'http://127.0.0.1:8086',
changeOrigin: true,
ws: true,
rewrite: (path) => path.replace(/^\/dev-api/, ''),
},
}环境变量
文件：.env.development / .env.production
| 变量 | 开发默认 | 生产示例 | 说明 |
|---|---|---|---|
VITE_APP_BASE_API | /dev-api | https://api.wujies.cn/ | 接口前缀 |
VITE_APP_PORT | 4230 | — | 开发端口 |
VITE_APP_CONTEXT_PATH | / | / | 部署子路径 |
VITE_APP_TITLE | 无界创镜系统 | 同左 | 页面标题 |
VITE_APP_ENCRYPT | false | false | 接口加密开关，必须与后端一致 |
生产环境如果走同域反向代理，把
VITE_APP_BASE_API改回/prod-api，由 Nginx 转发；直接写后端域名时要确认 CORS 已放开。
验收
- 首页能打开，商品 / 内容区有数据；
- 登录后进入会员中心；
- 打开浏览器 Network，
/open/**或/portal/**返回 200； - 如果返回 404，先去「我的应用」确认对应应用已安装（见 C 端接口与应用）。
PC 用户端登录页（截图占位）
/images/docs/pc-login.png建议 1920 × 1080。
生产构建
npm run build:prod产物在 dist/（含 gzip 资源），把整个目录交给 Nginx 即可。SPA 路由需要 fallback：
location / {
try_files $uri $uri/ /index.html;
}构建前确认 .env.production 的 VITE_APP_BASE_API 指向正确后端；构建后再改就得重新打包。