2、开发环境搭建:注册小程序账号、安装开发者工具、创建第一个小程序项目、熟悉开发者工具界面
说实话,很多新手学小程序,上来就急着写代码。我见过不少同学,工具都没摸熟,就开始复制粘贴,结果遇到个报错能卡半天。我的建议是——先把环境搭好,把工具玩明白。这就像你开车前,总得先知道油门刹车在哪吧?
2.1 注册小程序账号
第一步,你得有个「身份证」。去微信公众平台(mp.weixin.qq.com)注册一个小程序账号。注意,不是订阅号,也不是服务号,是「小程序」。
注册流程要点:
- 用未注册过微信公众平台的邮箱,一个邮箱只能绑一个
- 主体类型选「个人」或「企业」都行,个人版功能受限但够学习用
- 注册完成后,拿到 AppID——这是你小程序的唯一标识
我的小经验:AppID 一定要记好。我刚开始做项目时,随手把 AppID 写在便签上,结果换电脑找不到了,又得重新登录后台去查。建议你直接存到密码管理器里,或者项目根目录放个 .env 文件。
2.2 安装开发者工具
去官网下载「微信开发者工具」。别下错了,有稳定版和预发布版。我建议你用 稳定版,预发布版偶尔会有小 bug,折腾起来挺烦的。
安装过程很简单,一路下一步就行。不过有两点要注意:
- Windows 用户记得勾选「添加到 PATH」,方便命令行调用
- Mac 用户如果遇到「已损坏,无法打开」,去系统偏好设置里允许一下就行
我曾经踩过的坑:有一次升级了开发者工具,结果项目编译报错,折腾了半天才发现是工具版本和基础库不兼容。所以,别手贱频繁升级,一个项目周期内保持工具版本稳定就好。
2.3 创建第一个小程序项目
工具装好了,咱们来创建第一个项目。打开开发者工具,点击「新建项目」。
你会看到这样一个界面:
项目名称:my-first-app
目录:选择一个空文件夹
AppID:填写你注册好的 AppID
开发模式:小程序
后端服务:不使用云服务
语言:JavaScript
模板:选择「不使用模板」
嗯,这里我要多说一句。很多教程让你选「JS 基础模板」,但我个人习惯选「不使用模板」。为什么?因为模板里塞了一堆你暂时看不懂的代码,反而容易让你分心。从零开始,自己一行行写,理解才深刻。
点击「确定」,工具会自动生成一个基础项目结构。你会看到这样的目录:
my-first-app/
├── pages/
│ └── index/
│ ├── index.js
│ ├── index.json
│ ├── index.wxml
│ └── index.wxss
├── app.js
├── app.json
├── app.wxss
└── project.config.json
别被这么多文件吓到。说白了,每个页面就是一套「四件套」:
| 文件 | 作用 | 类比 |
|---|---|---|
| .wxml | 页面结构 | HTML |
| .wxss | 页面样式 | CSS |
| .js | 页面逻辑 | JavaScript |
| .json | 页面配置 | 配置文件 |
你想想看,这不就是前端开发那套老本行吗?只是换了个后缀名而已。
2.4 熟悉开发者工具界面
工具界面分几个区域,我带你快速过一遍:
- 左侧:模拟器——实时预览你的小程序长啥样。可以切换手机型号、网络环境
- 中间:编辑器——写代码的地方。支持代码高亮、自动补全
- 右侧:调试器——类似 Chrome DevTools,看日志、查网络请求、调样式
- 顶部工具栏——编译、预览、上传、清缓存等操作
我常用的几个快捷键:
Ctrl + S:保存并自动编译刷新Ctrl + Shift + P:打开命令面板F5:重新编译
记住,保存即编译,这是小程序开发最爽的地方。你改一行代码,模拟器里立刻就能看到效果。
还有一个功能我特别想提——「真机调试」。点击工具栏的「预览」,用手机微信扫码,就能在手机上跑你的小程序。我在项目中遇到过好几次,模拟器里一切正常,真机上一跑就崩。所以,别光盯着模拟器,多拿真机测测。
注意:真机调试时,手机和电脑必须在同一个局域网下。另外,调试模式下性能会比正式包慢一些,这是正常的。
2.5 第一个 Hello World
环境搭好了,咱们来写点东西。打开 pages/index/index.wxml,把里面的内容全删了,改成:
<view class="container">
<text>Hello, 小程序!</text>
</view>
然后打开 pages/index/index.wxss,加一点样式:
.container {
display: flex;
justify-content: center;
align-items: center;
height: 100vh;
font-size: 32rpx;
color: #333;
}
保存一下,看看模拟器。是不是显示了一行字?恭喜你,第一个小程序跑起来了。
你可能会问:「为什么用 rpx 而不是 px?」
这是个好问题。rpx 是微信小程序的响应式单位,它会根据屏幕宽度自动缩放。说白了,你写 32rpx,在 iPhone 6 上就是 16px,在 iPhone 12 Pro Max 上会自动变大一点。这样你就不用为不同屏幕写一堆媒体查询了。
总结一下今天的内容:
- 注册小程序账号,拿到 AppID
- 安装稳定版开发者工具
- 创建项目,理解「四件套」文件结构
- 熟悉工具界面:模拟器、编辑器、调试器
- 写出第一个 Hello World
环境搭好了,下一章咱们就开始真正写代码了。到时候我会带你深入小程序的页面生命周期——说白了,就是你的页面从生到死都经历了什么。