76 lines
1.9 KiB
Markdown
76 lines
1.9 KiB
Markdown
# my-test
|
|
|
|
一个协同办公项目
|
|
|
|
## 安装
|
|
|
|
```
|
|
npm install
|
|
```
|
|
|
|
## 运行
|
|
|
|
```
|
|
npm run serve:test //本地运行，并且代理到测试环境
|
|
npm run serve:uat //本地运行，并且代理到预发布环境
|
|
npm run serve //本地运行，并且代理到生产环境
|
|
```
|
|
|
|
## 打包
|
|
|
|
```
|
|
// 测试环境
|
|
npm run build:test
|
|
|
|
// 预发布环境
|
|
npm run build:uat
|
|
|
|
// 生产环境
|
|
npm run build
|
|
```
|
|
|
|
## 说明
|
|
|
|
项目采用vue3.0 + vite搭建，组件库默认引入了ant-design-vue，状态管理使用pinia。
|
|
|
|
## 常见问题
|
|
|
|
### 环境变量
|
|
|
|
环境变量放在env目录下，.env文件必定会加载，mode=test时，.env.test会加载，变量优先级，.env.test > .env ，因此，相同变量名，.env里的会被忽略。
|
|
|
|
### 按需引入组件
|
|
|
|
项目使用 unplugin-vue-components 插件，它可以自动引入组件，并按需引入组件的样式，无需手动引入样式。
|
|
|
|
```JS
|
|
import {
|
|
Button
|
|
} from 'ant-design-vue';
|
|
```
|
|
|
|
### 引入函数组件的样式
|
|
|
|
ant-design-vue 中有个别组件是以函数的形式提供的，比如 message 组件。在使用函数组件时，unplugin-vue-components 无法自动引入对应的样式，因此需要手动引入样式。
|
|
|
|
```JS
|
|
import {
|
|
message
|
|
} from 'ant-design-vue';
|
|
import 'ant-design-vue/es/message/style/css';
|
|
```
|
|
|
|
### 主题变量
|
|
|
|
主题变量在 src/styles/theme.json 中定义，项目跑起来后会注入到less，在less中通过 @ 变量名称使用，例如：background-color: @colorPrimary 。 主题变量同时也会注入到 <a-config-provider> 中，具体可在该组件的 theme 属性配置，实现动态切换主题。
|
|
|
|
### 本地代理
|
|
|
|
运行项目时的接口代理，可在 vite.util.ts 的 proxyConfig 方法中配置。
|
|
|
|
## 相关文档
|
|
|
|
[vue3.0 文档](https://cn.vuejs.org/guide/quick-start.html).
|
|
[vite 文档](https://vitejs.cn/).
|
|
[Ant Design of Vue 文档](https://www.antdv.com/docs/vue/introduce-cn).
|