### 一 项目简介

卫勤先锋基础组件库

### 二 环境要求

#### 2.1 开发环境
- 操作系统：Windows 10/11，MacOS；
- Node 16.14.0 及以上版本(某些情况下可能需要安装 Python3 环境)；
- pnpm v10.1.0及以上版本；
- yarn v1.22.x版本；
- 浏览器推荐使用 Chrome 90及以上版本；
- Visual Studio Code (简称VSCode)
#### 2.2 运行环境
Nginx 1.18.0 及以上版本

### 三 浏览器支持
 
Google Chrome 浏览器，不支持IE

 
### 四 使用说明
 
#### 4.1 开发环境
##### 4.1.1 安装pnpm
推荐使用 pnpm，若使用 yarn ，建议使用 Yarn v1.22.x 版本，否则可能出现依赖安装失败的情况。
在Windows的PowerShell中执行如下命令
iwr https://get.pnpm.io/install.ps1 -useb | iex
MacOS 通过 Homebrew 安装 pnpm若已经安装了 Homebrew 软件包管理器，则可以使用如下命令赖安装 pnpm：
brew install pnpm
也可以通过 npm 安装 pnpm或者yarn
npm install -g pnpm
或
npm install -g yarn
##### 4.1.2 安装依赖
使用如下命令安装项目依赖
pnpm install
##### 4.1.3 后端接口配置
修改项目根目录 .env.development 中的后端接口地址
VITE_APP_BASE_URL=''  

##### 4.1.4 本地运行
完成上述操作后，使用如下命令运行前端项目
pnpm serve
#### 4.2 运行环境
测试或生产环境
如果需要测试或生产环境发布，使用如下命令打包项目
pnpm build
然后将项目根目录下 /dist/ 中所有的文件上传至服务器。

### 五 常见问题
 
#### 5.1 修改项目基本信息
打开项目根目录 .env 文件，可以看到 本地运行端口号、网站标题、简称 等配置。
端口号
VITE_PORT =3100

网站标题
VITE_APP_TITLE= 卫勤先锋
#### 5.2 代码更新后报错
在开发或打包时报依赖缺失，可以先删除项目根目录下的 pnpm-lock.yaml 文件，然后重新执行 pnpm install 安装依赖即可解决。