这篇文章面向已经会一点 JavaScript、想亲手把第一个微信小程序跑起来的开发者。我会用一个「待办清单」示例,把注册、环境、目录结构、页面逻辑、云开发数据存储、真机调试到上线,按实际操作顺序走一遍。读完你就能有一个能用的最小可用版本,再按自己的需求往上加功能。

一、先把账号和工具准备好
做微信小程序,第一步不是写代码,而是拿到 AppID。流程很简单:
- 打开微信公众平台,注册「小程序」类型账号,用邮箱激活;
- 在「开发管理 - 开发设置」里拿到 AppID,个人主体也能注册,但类目和支付能力有限制;
- 下载「微信开发者工具」,选择稳定版即可,安装后用微信扫码登录。
新建项目时填入 AppID,选择「不使用云服务」或「微信云开发」都可以。本文示例用云开发,省掉自己搭服务器和后端的环节。
二、认识项目目录
新建后工具会生成一套骨架,核心文件只有几个:
app.js:全局逻辑,注册小程序实例;app.json:全局配置,页面路径、窗口样式、tabBar 都在这里;app.wxss:全局样式;pages/:每个页面一个目录,包含.js、.json、.wxml、.wxss四个文件。
小程序没有 DOM,视图层用 WXML 描述结构,样式用 WXSS,逻辑在 JS 里通过 setData 驱动视图更新。理解这一点,后面写页面就不会往「操作节点」的方向走偏。
三、写第一个页面:待办清单
在 app.json 的 pages 数组里加一个页面路径,工具会自动创建对应文件。页面结构如下:
<view class="page">
<view class="input-row">
<input value="{{draft}}" bindinput="onInput" placeholder="输入待办事项" />
<button type="primary" size="mini" bindtap="onAdd">添加</button>
</view>
<view wx:for="{{todos}}" wx:key="_id" class="item">
<text bindtap="onToggle" data-id="{{item._id}}">{{item.done ? '✓' : '○'}} {{item.title}}</text>
</view>
</view>
对应逻辑集中在 Page 对象里。注意所有异步回调中修改数据都要走 setData,直接改 this.data 不会触发渲染:
Page({
data: { draft: '', todos: [] },
onLoad() { this.loadTodos(); },
onInput(e) { this.setData({ draft: e.detail.value }); },
onAdd() {
const title = this.data.draft.trim();
if (!title) return;
const db = wx.cloud.database();
db.collection('todos').add({ data: { title, done: false, createdAt: Date.now() } })
.then(() => { this.setData({ draft: '' }); this.loadTodos(); });
},
loadTodos() {
wx.cloud.database().collection('todos').orderBy('createdAt', 'desc').get()
.then(res => this.setData({ todos: res.data }));
}
});
这段代码已经覆盖了输入、写入、读取三个动作,是大多数小程序的骨架形态。
四、接入云开发
云开发把数据库、存储、云函数打包在微信侧,免去服务器和备案。启用步骤:
- 在开发者工具点「云开发」,按提示开通环境,记下环境 ID;
- 在
app.js的onLaunch里初始化:
App({
onLaunch() {
wx.cloud.init({ env: '你的环境ID', traceUser: true });
}
});
然后在云开发控制台新建集合 todos,权限设为「仅创建者可读写」即可。数据库是文档型,字段自由,前期不用设计表结构,非常适合快速验证想法。等数据量上来或逻辑变复杂,再把关键逻辑迁到云函数里,避免客户端直接操作数据。
五、真机调试与上线
模拟器跑通之后,点工具栏「预览」用手机扫码,重点看三件事:
- 首屏加载是否明显卡顿,图片是否过大;
setData的调用频率和数据量,列表页尽量只传变化的部分;- 网络请求失败时的提示,用户看不到控制台,必须有兜底文案。
上线前在公众平台完成类目选择、隐私协议填写,然后点开发者工具的「上传」,回到后台「版本管理」提交审核。审核通过后点「发布」,小程序才真正对用户可见。后续每次更新都是上传新版本、重新提交审核的流程。
六、接下来可以做什么
有了这个最小闭环,扩展方向就很清晰了:加用户体系用 wx.login 换 openid,做分享用 onShareAppMessage,需要消息通知就上订阅消息。建议先把一个核心动作做顺,再逐步堆功能,避免一开始就把页面和逻辑铺得太散。真正决定小程序好不好用的,往往是加载速度和交互细节,而不是功能数量。

评论 (0)
还没有评论,快来抢沙发吧~