很多新手卡在安装配置环节,今天我来手把手教大家把开发环境搭好。跟着步骤走,十分钟就能跑起第一个小程序。
第一步,安装微信开发者工具。去微信公众平台下载最新的稳定版。下载的时候有两个版本可选,稳定版和预发布版。预发布版功能更多,但可能不太稳定,新手建议选稳定版。安装过程很普通,一直点下一步就好。装完之后登录自己的微信账号就能用了。
第二步,安装Node.js。为什么要装这个?因为uni-app、Taro这些框架都依赖Node.js。去Node.js官网下载LTS版本,就是那个长期支持版。版本号选18或者20都可以,太老的版本可能有兼容问题。安装的时候注意一下,有个选项是Add to PATH,一定要勾选,不然要手动配置环境变量,很麻烦。装完之后打开命令行,输入node -v,看到版本号就说明装好了。
第三步,安装代码编辑器。我推荐VS Code。去官网下载对应系统的版本。装完之后建议装几个插件:MiniProgram、Wxml -和小程序员助手。这几个插件能提供代码提示、语法高亮、错误检查等功能,用起来会舒服很多。
第四步,安装uni-app的开发工具。如果你打算用uni-app框架开发小程序,还需要装HBuilderX。这是uni-app官方出的IDE,对这个框架支持最好。去官网下载App开发版,不要下错了。下载完解压到合适的目录,比如Windows用户可以放在D盘,Mac用户放在应用程序文件夹里。打开HBuilderX,在菜单栏找到工具-预安装插件,把需要的插件装上。
第五步,创建第一个项目。打开HBuilderX,点菜单栏的文件-新建-项目。左边选择uni-app,输入项目名称,选择保存路径,模板选默认模板就行。点创建,等待一下项目就建好了。
第六步,运行项目。项目创建好之后,点击工具栏的运行按钮,选择运行到小程序模拟器-微信开发者工具。如果是第一次运行,HBuilderX会提示配置微信开发者工具的路径。按照提示找到你安装微信开发者工具的位置,配置好之后再点运行。
如果一切正常,HBuilderX会自动打开微信开发者工具,并且在模拟器里显示你的小程序界面。底部会有编译日志,如果显示编译成功,那恭喜你,环境搭建完成了。
最后说一下常见问题。
问题一,运行时提示路径不对。这个是因为微信开发者工具的安全设置没开。打开微信开发者工具,点设置-安全设置,把服务端口打开。然后重新在HBuilderX里运行就好了。
问题二,编译失败。这个一般是Node.js版本不对或者项目路径有中文。检查一下Node.js版本,确保是18或20。然后确认项目保存路径没有中文。
问题三,微信开发者工具里看不到项目。这个可能是路径配置错了,重新配置一下。还有一种可能是微信开发者工具没有登录,重新登录一下试试。
好了,环境配置就讲完了。有什么问题欢迎留言,我会尽量解答。