86 lines
1.8 KiB
Markdown
86 lines
1.8 KiB
Markdown
该项目已经基于 [vue-pure-admin](https://github.com/pure-admin/vue-pure-admin) 精简版进行了国际化版本的修改，使用 `pnpm` 安装依赖即可快速启动项目。以下是安装和运行步骤：
|
|
|
|
### 安装
|
|
|
|
请确保你已安装以下工具：
|
|
|
|
- **Node.js** >=18.18.0 或 >=20.9.0 或 >=22.0.0
|
|
- **pnpm** >=9
|
|
|
|
#### 1. 安装依赖
|
|
|
|
在项目根目录下运行以下命令以安装所有依赖：
|
|
|
|
```bash
|
|
pnpm install
|
|
```
|
|
|
|
该命令会根据 [pnpm-lock.yaml](./pnpm-lock.yaml) 文件精确还原依赖环境，保证构建的一致性。
|
|
|
|
---
|
|
|
|
### 运行项目
|
|
|
|
#### 2. 启动本地开发服务器
|
|
|
|
```bash
|
|
pnpm dev
|
|
```
|
|
|
|
这将启动本地开发服务器，默认访问地址为：[http://localhost](http://localhost)
|
|
|
|
---
|
|
|
|
### 构建生产环境包
|
|
|
|
如果你需要构建用于生产的静态资源包，可以使用以下命令：
|
|
|
|
```bash
|
|
pnpm build
|
|
```
|
|
|
|
如果需要构建 staging 测试环境版本：
|
|
|
|
```bash
|
|
pnpm build:staging
|
|
```
|
|
|
|
构建完成后，生成的文件会存放在 [dist/](./dist) 目录中。
|
|
|
|
---
|
|
|
|
### 部署到 Docker
|
|
|
|
本项目支持通过 Docker 快速部署到 Nginx 服务器。
|
|
|
|
#### 3. 构建 Docker 镜像
|
|
|
|
```bash
|
|
docker build -t frontend-template-i18n .
|
|
```
|
|
|
|
#### 4. 运行容器
|
|
|
|
```bash
|
|
docker run -d -p 80:80 frontend-template-i18n
|
|
```
|
|
|
|
---
|
|
|
|
### 技术说明
|
|
|
|
- **构建工具**: Vite + pnpm
|
|
- **打包体积**: 默认小于 2.3MB，启用 Brotli 压缩后可缩小至 350KB 以下
|
|
- **UI库**: Element Plus v2.9.0
|
|
- **状态管理**: Pinia v2.3.0
|
|
- **国际化**: vue-i18n v10.0.5
|
|
- **样式方案**: TailwindCSS + SCSS
|
|
- **HTTP请求**: Axios + Localforage 缓存
|
|
- **代码规范**: ESLint + Prettier + Stylelint
|
|
|
|
---
|
|
|
|
### 注意事项
|
|
|
|
如需查看详细文档，请参考 [README.md](https://github.com/pure-admin/pure-admin-thin/tree/i18n) 文件。
|