156 lines
3.1 KiB
Markdown
156 lines
3.1 KiB
Markdown
|
# JinBooks Web UI
|
|||
|
|
|
|||
|
|
这是 JinBooks 项目的前端部分，基于 Vue.js + Vite 构建。
|
|||
|
|
该项目旨在提供一个高性能、模块化、易扩展的现代前端架构。
|
|||
|
|
|
|||
|
|
## 快速开始
|
|||
|
|
|
|||
|
|
### 克隆项目
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
git clone https://your.repo.url/jinbooks-ui.git
|
|||
|
|
cd jinbooks-ui
|
|||
|
|
````
|
|||
|
|
|
|||
|
|
### 安装依赖
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npm install
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 启动开发服务器
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npm run dev
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
开发服务器将在本地启动，默认地址通常为：
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
http://localhost:3154
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 构建与部署
|
|||
|
|
|
|||
|
|
### 构建生产版本
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npm run build
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 部署到服务器
|
|||
|
|
|
|||
|
|
将 `dist` 目录中的文件上传至你的服务器，并配置相应的 Web 服务（如 Nginx）。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 常用命令
|
|||
|
|
|
|||
|
|
| 命令 | 说明 |
|
|||
|
|
|-----------------|------------|
|
|||
|
|
| `npm run dev` | 启动开发服务器 |
|
|||
|
|
| `npm run build` | 构建生产版本 |
|
|||
|
|
| `npm run lint` | 代码格式检查 |
|
|||
|
|
| `npm run test` | 运行单元测试 |
|
|||
|
|
| `npm run serve` | 本地预览构建后的文件 |
|
|||
|
|
|
|||
|
|
## 目录结构说明
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
jinbooks-web-fronted/
|
|||
|
|
├── public/ # 静态资源
|
|||
|
|
├── src/ # 源代码
|
|||
|
|
│ ├── assets/ # 资源文件
|
|||
|
|
│ ├── components/ # 公共组件
|
|||
|
|
│ ├── views/ # 页面组件
|
|||
|
|
│ ├── store/ # Vuex 状态管理
|
|||
|
|
│ ├── router/ # 路由配置
|
|||
|
|
│ ├── utils/ # 工具函数
|
|||
|
|
│ ├── styles/ # 样式文件
|
|||
|
|
│ ├── App.vue # 根组件
|
|||
|
|
│ └── main.js # 应用入口
|
|||
|
|
├── .gitignore # Git 忽略配置
|
|||
|
|
├── package.json # 项目信息及依赖
|
|||
|
|
├── README.md # 项目说明文档
|
|||
|
|
└── vite.config.js # Vite 配置
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 贡献指南
|
|||
|
|
|
|||
|
|
欢迎为本项目贡献代码！请遵循以下流程：
|
|||
|
|
|
|||
|
|
1. Fork 本仓库
|
|||
|
|
|
|||
|
|
2. 创建新分支：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
git checkout -b feature/your-feature
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
3. 提交更改：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
git commit -m "Add: your feature"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
4. 推送到远程分支：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
git push origin feature/your-feature
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
5. 提交 Pull Request（PR）
|
|||
|
|
|
|||
|
|
## 版本管理
|
|||
|
|
|
|||
|
|
本项目采用 [语义化版本控制 (SemVer)](https://semver.org/lang/zh-CN/)，版本格式为：
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
MAJOR.MINOR.PATCH
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
例如：`1.0.0`、`2.1.3` 等。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 依赖说明
|
|||
|
|
|
|||
|
|
本项目主要使用以下依赖：
|
|||
|
|
|
|||
|
|
* **Vue.js**：核心框架
|
|||
|
|
* **Pinia**：状态管理
|
|||
|
|
* **Vue Router**：路由管理
|
|||
|
|
* **Element Plus**：UI 组件库
|
|||
|
|
* **Axios**：HTTP 请求库
|
|||
|
|
|
|||
|
|
## 问题排查
|
|||
|
|
|
|||
|
|
若运行或构建过程中出现问题，请尝试以下操作：
|
|||
|
|
|
|||
|
|
1. 确保已正确安装 Node.js 和 npm
|
|||
|
|
|
|||
|
|
2. 检查网络连接，确保可以正常访问 npm 仓库
|
|||
|
|
|
|||
|
|
3. 清理缓存后重新安装依赖：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npm cache clean --force
|
|||
|
|
npm install
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
4. 查看控制台错误信息并定位问题
|
|||
|
|
|
|||
|
|
如仍未解决，请提交 Issue 或联系维护者。
|
|||
|
|
|
|||
|
|
## 清理缓存
|
|||
|
|
|
|||
|
|
如果需要清理 npm 缓存，可执行以下命令：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npm cache clean --force
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
感谢使用 JinBooks 前端项目，如有建议或问题，欢迎提交 Issue 或参与贡献！
|