@wqxf/base-components
Version:
卫勤先锋基础组件库
61 lines (49 loc) • 1.92 kB
Markdown
## 一 项目简介
卫勤先锋基础组件库
## 二 环境要求
### 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 安装依赖即可解决。