专注小程序 / APP 开发,用代码改变生活

获取方案
全国分站 主站首页 北京分站 石家庄分站 唐山分站 保定分站 廊坊分站 沧州分站 郑州分站 邯郸分站

从零搭建一个微信小程序

小程序开发 2026-11-10 18 阅读 0 点赞 原创

这篇文章面向已经会一点 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 }));
  }
});

这段代码已经覆盖了输入、写入、读取三个动作,是大多数小程序的骨架形态。

四、接入云开发

云开发把数据库、存储、云函数打包在微信侧,免去服务器和备案。启用步骤:

  1. 在开发者工具点「云开发」,按提示开通环境,记下环境 ID;
  2. 在 app.js 的 onLaunch 里初始化:
App({
  onLaunch() {
    wx.cloud.init({ env: '你的环境ID', traceUser: true });
  }
});

然后在云开发控制台新建集合 todos,权限设为「仅创建者可读写」即可。数据库是文档型,字段自由,前期不用设计表结构,非常适合快速验证想法。等数据量上来或逻辑变复杂,再把关键逻辑迁到云函数里,避免客户端直接操作数据。

五、真机调试与上线

模拟器跑通之后,点工具栏「预览」用手机扫码,重点看三件事:

  • 首屏加载是否明显卡顿,图片是否过大;
  • setData 的调用频率和数据量,列表页尽量只传变化的部分;
  • 网络请求失败时的提示,用户看不到控制台,必须有兜底文案。

上线前在公众平台完成类目选择、隐私协议填写,然后点开发者工具的「上传」,回到后台「版本管理」提交审核。审核通过后点「发布」,小程序才真正对用户可见。后续每次更新都是上传新版本、重新提交审核的流程。

六、接下来可以做什么

有了这个最小闭环,扩展方向就很清晰了:加用户体系用 wx.login 换 openid,做分享用 onShareAppMessage,需要消息通知就上订阅消息。建议先把一个核心动作做顺,再逐步堆功能,避免一开始就把页面和逻辑铺得太散。真正决定小程序好不好用的,往往是加载速度和交互细节,而不是功能数量。

微信小程序云开发实战:从零搭建一个记账本小程序定制:从需求到上线的完整实践

评论 (0)

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

好想法,值得被认真交付

从小程序、APP 到全栈网站,一站式把想法变成可落地的产品

微信咨询

微信扫码,直接沟通需求