注意事项 ​

"$w"被占用 ​

wu-ui 有很多的自带的js工具函数，挂载在$w对象中，而$w又挂载在uni中, 所以请勿在uni中挂载同名的变量。

wu-ui对nvue的支持 ​

wu-ui 全方面支持nvue，让您在开发APP时可以无需顾虑兼容性问题。

对VUE3的支持 ​

wu-ui 全面兼容VUE3及NVUE。

技术点要求 ​

1. wu-ui依赖SCSS预处理器，所以您需要给HBuilder X安装 “sass/scss编译” 插件，详见快速上手
2. wu-ui基于HX的最新版本开发，旧版本可能会不兼容，如遇问题，请升级HX尝试是否可解决
3. wu-ui要求项目开启uniapp的V3版本，V3有很大的优势，详见V3版本介绍

关于Hbuilder X ​

uniapp依赖于HX，uniapp经过这六年发展(2018-2023)，势头强劲，茁壮成长。我们目睹了整个过程，陪着uniapp一起成长，感慨能有 一家良心企业能扎根技术，埋头苦干，把APP，H5还有各家小程序做到大一统，同时也愤慨各家大厂的小程序各自为营，仿佛倒退到多年前 各家浏览器大战 (opens new window)的时代，让人唏嘘不已。 根据我们的经验，我们强烈建议:

• 开发者在开发线上项目的时候只使用HX的稳定版
• 初学者不要使用HX内测版，不然会碰到莫名其妙的问题，会挫败学习信心
• 每当HX更新大功能的时候，比如以往的自定义组件模式，近来的V3版本，还是目前的uniCloud，或者以后可能关于nuve的大功能，线上项目请过一段时间再使用。
• 建议喜欢尝鲜并熟悉uniapp的用户，在电脑分别安装HX的稳定版和内测版，尝鲜使用内测版，开发使用稳定版，二者分别更新，互不干扰

编译调试 ​

开发的时候，特别是写布局的时候，我们建议使用chrome或者HX内置的浏览器，需要说明的是，电脑浏览器的预览效果是不精细的， 写完之后，可以手机连上电脑同一局域网的WiFi，在手机浏览器上再进行细微的调整。 写完布局再写逻辑的时候，如果还需要兼容小程序和APP，一定要每写完一个页面，就用APP基座和小程序真机进行调试，这能及早发现问题，否则会剪不断理还乱。

内网穿透 ​

有时候需要通过花生壳等工具，进行内网穿透，让外部的人可以访问到本地的调试网页，这时由于webpack-dev-server会默认检查hostname， 去掉此限制即可，在uniapp项目根目录下新建vue.config.js文件(如果有，不用创建)，修改如下内容：

module.exports = {
	configureWebpack: {
		devServer: {
			disableHostCheck: true
		}
	}
}

module.exports = {
	configureWebpack: {
		devServer: {
			disableHostCheck: true
		}
	}
}

安全区适配(针对APP) ​

在iPhone X等机型，底部带有指示条，如果配置了safearea则会在底部生成一个原生的白色区块，好处是不会导致 误触，缺点是颜色无法修改，有时候也影响美观。 wu-ui在各个可能会受到指示条影响的地方都做了特别处理，比如弹窗，键盘组件等，详见底部安全区适配

为什么wi-ui的源码中会有那么多的注释？ ​

很多开源项目，发布的时候都会刻意去掉注释，这可能是为了干净整洁，也可能是为了减少体积，还可能是出品方认为用户不会，也没必要去阅读源码。 相反，wi-ui不这么认为，我们会一直将注释保留在发行的版本中，这些注释不是为了给我们自己看的，而是为了给用户看的。 我们希望用户在使用的过程中，能通过阅读源码，既能提升工作效率，还能学到知识。因为wi-ui的理念是"挣脱束缚，向往自由"，我们也希望您在阅读 源码的过程中，如果发现问题，或者有更好的实现方式和想法，可以反馈给我们，进而构建一个更强健的UI框架。