一 项目简介

卫勤先锋基础组件库

二 环境要求

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 安装依赖即可解决。