一个文档中的注意事项，往往是发生问题的原因，这里整合了我认为容易发生的错误（为了方便我搜索问题）

1.static 目录下的 js 文件不会被编译，如果里面有 es6 的代码，不经过转换直接运行，在手机设备上会报错。

2.css、less/scss 等资源同样不要放在 static 目录下，建议这些公用的资源放在 common 目录下。

3.template内引入静态资源，如image、video等标签的src属性时，可以使用相对路径或者绝对路径。

4.js文件不支持使用/开头的方式引入。

5.css文件或style标签内引入css文件时（scss、less文件同理），只能使用相对路径。

6.编译期判断环境可用条件编译，运行期判断可用uni.getSystemInfoSync().platform判断环境。

7.在字体或高度中使用了 rpx ，那么需注意这样的写法意味着随着屏幕变宽，字体会变大、高度会变大。如果你需要固定高度，则应该使用 px 。

8.App端，在 pages.json 里的 titleNView 或页面里写的 plus api 中涉及的单位，只支持 px，不支持 rpx。

9.小程序不支持在css中使用本地文件，包括本地的背景图和字体文件。需以base64方式方可使用。

10.背景图片微信小程序不支持相对路径（真机不支持，开发工具支持）。

11.字体图标网络路径必须加协议头 https。

12.非 H5 端不支持使用含有 dom、window 等操作的 vue 组件和 js 模块，安装的模块及其依赖的模块使用的 API 必须是 uni-app 已有的 API。

13.小程序组件需要放在项目特殊文件夹 wxcomponents（或 mycomponents、swancomponents）。

14.当需要在 vue 组件中使用小程序组件时，注意在 pages.json 的 globalStyle 中配置 usingComponents，而不是页面级配置。

15.以:style=""这样的方式设置px像素值，其值为实际像素，不会被编译器转换。

16.若需要禁止蒙版下的页面滚动，可使用 @touchmove.stop.prevent="moveHandle"，moveHandle 可以用来处理 touchmove 的事件，也可以是一个空函数。

17.App端和H5端支持v-html，其他端不支持v-html。

18.uni-app不需要 plus ready 在html中使用plus的api。

19.在普通的 H5+ 项目中，需要使用 document.addEventListener 监听原生扩展的事件。uni-app 中，没有 document。可以使用 plus.globalEvent.addEventListener 来实现。

20.App端若要使用操作window、document的库，需要通过renderjs来实现。

21.tabbar 切换第一次加载时可能渲染不及时，可以在每个tabbar页面的onLoad生命周期里先弹出一个等待雪花。

22.tabbar 的页面展现过一次后就保留在内存中，再次切换 tabbar 页面，只会触发每个页面的onShow，不会再触发onLoad。

23.分包加载配置，subPackages 为小程序的分包加载机制。在App里始终为整包。subPackages 里的pages的路径是 root 下的相对路径，不是全路径。

24.splash（启动封面）是App必然存在的、不可取消的。splash只能是标准png，不要用jpg改名为png。

25.所有组件与属性名都是小写，单词之间以连字符-连接。

26.APP-vue和小程序中，请勿在 scroll-view 中使用 map、video 等原生组件。小程序中 scroll-view 中也不要使用 canvas、textarea 原生组件。

27.scroll-view 不适合放长列表，有性能问题。长列表滚动和下拉刷新，应该使用原生导航栏搭配页面级的滚动和下拉刷新实现。

28.除了文本节点以外的其他节点都无法长按选中。

 29.如需调节checkbox,radio大小，可通过css的scale方法调节，如缩小到70%style="transform:scale(0.7)"。

30.页面结构复杂，css样式太多的情况，使用 image 可能导致样式生效较慢，出现 “闪一下” 的情况，此时设置 image{will-change: transform} ,可优化此问题。

31.自定义组件里面使用 时，若 src 使用相对路径可能出现路径查找失败的情况，故建议使用绝对路径。

32.App平台：使用  组件，打包 App 时必须勾选 manifest.json->App 模块权限配置->VideoPlayer 模块。

33.App平台：如果使用的视频路径为本地路径，需要配置资源为释放模式：在 manifest.json 文件内 app-plus 节点下新增 runmode 配置，设置值为liberate。

34.webview在App 平台同时支持网络网页和本地网页，但本地网页及相关资源（js、css等文件）必须放在 uni-app 项目根目录->hybrid->html 文件夹下；小程序仅支持加载网络网页，不支持本地html。

35.H5端onBackPress只能监听页面导航栏的返回按钮的点击事件，不能监听浏览器返回以及手机的返回。

36.发出请求的method的值必须大写，有效值在不同平台差异说明不同。

37.localhost、127.0.0.1等服务器地址，只能在电脑端运行，手机端连接时不能访问。请使用标准IP并保证手机能连接电脑网络。

38.App支持多文件上传，微信小程序只支持单文件上传，传多个文件需要反复调用本API。所以跨端的写法就是循环调用本API。

39.如果想打开web url，在App平台可以使用 plus.runtime.openURL或web-view组件；H5平台使用 window.open；小程序平台使用web-view组件（url需在小程序的联网白名单中）。

40.navigateTo, redirectTo 只能打开非 tabBar 页面,switchTab 只能打开 tabBar 页面.

41.H5端页面刷新之后页面栈会消失，此时navigateBack不能返回，如果一定要返回可以使用history.back()导航到浏览器的其他历史记录.

42.App端如需选择非媒体文件，可在插件市场搜索文件选择，其中Android端可以使用Native.js，无需原生插件，而iOS端需要原生插件。

43.关于一些权限的使用，类似相机，语音，都要先判断一下设备的访问权限是否开启。

44.屏幕高度=状态栏高度+原生导航栏高度+可使用窗口高度+原生tabbar高度。

45.分享到 QQ 必须含有 href 链接，分享文字到 QQ 时，title 必选，不能直接分享到QQ空间，可以分享到QQ，然后在QQ的界面里选择QQ空间。

46.从APP分享到微信时，无法判断用户是否点击取消分享，因为微信官方禁掉了分享成功的返回值。

47.支付的传参要注意orderInfo在不同的环境下传参类型不一致。

48.关于文本超出展示...，需要在超出展示盒子的内部在内嵌一层子元素，否则app端会有问题。