uni-app vue-cli项目 uView安装及配置

一、说明
uView安装有下载安装和npm安装两种方式，使用的是npm安装。

二、步骤
1、安装SCSS

uView依赖SCSS，您必须要安装此插件，否则无法正常运行。

// 安装node-sass
npm i node-sass -D

// 安装sass-loader
npm i sass-loader -D
2、对uView进行npm安装

// 安装
npm install uview-ui
3、引入uView主JS库

在项目根目录中的main.js中，引入并使用uView的JS库，注意这两行要放在import Vue之后。

// main.js
import uView from "uview-ui";
Vue.use(uView);
4、引入uView的全局SCSS主题文件

在项目根目录的uni.scss中引入此文件。

/ uni.scss /
@import 'uview-ui/theme.scss';
5、在App.vue中引入uView基础样式

/* 注意要写在第一行，同时给style标签加入lang="scss"属性 */
@import "uview-ui/index.scss";

</style>
6、配置easycom组件模式

此配置需要在项目根目录的pages.json中进行。uni-app为了调试性能的原因，修改easycom规则不会实时生效，配置完后，重新编译项目才能正常使用uView的功能。

// pages.json
{

"easycom": {
    "^u-(.*)": "uview-ui/components/u-$1/u-$1.vue"
},

// 此为本身已有的内容
"pages": [
    // ......
]

}
遇到问题：

执行完上面的步骤后，重新编译时报错。

解决问题：

经过排查，应该是sass-loader的版本过高问题。在package.json文件中修改sass-loader，从12.x.x（忘记具体是多少了）改成10.1.0，执行npm install安装依赖，然后重新编译项目，编译成功，可正常使用uView组件。

// package.json
"node-sass": "^6.0.1",
"sass-loader": "^10.1.0", // 修改后
记录于2021/09/03。

标签: none