微信小程序开发文档
-
2026-08-31
昆明
- 返回列表
在移动互联网时代,微信小程序以其“无需下载、即用即走”的特性,成为连接用户与服务的重要桥梁。对于开启者而言,小程序开发门槛相对较低,生态成熟。本文旨在为初学者提供一份清晰、可操作的入门指南,带你一步步完成第一个小程序的开发与上线。
第一步:开发前的准备工作
1.1 注册小程序账号
访问平台:前往微信公众平台官网,点击“迅速注册”,选择“小程序”。
填写信息:使用未注册过公众号或小程序的邮箱进行注册,并按照指引填写主体信息(个人或企业)、管理员信息等。
完成认证:提交后,登录邮箱激活账号。若选择企业主体,通常需要支付300元认证费(个人主体免认证费)。
1.2 获取开启者ID
登录小程序管理后台,在左侧菜单栏找到“开发”->“开发管理”。
在“开发设置”页面,记录你的 AppID(小程序ID) 。这是项目的仅此标识,后续创建项目时必须填写。
1.3 安装开启者工具
在管理后台“开发”->“开发工具”菜单中,下载并安装蕞新版本的“微信开启者工具”。它提供了代码编辑、调试、预览和上传的一体化环境。
第二步:创建并初始化你的第一个项目
2.1 新建项目
打开微信开启者工具,使用微信扫码登录。
点击“+”号或“新建项目”,进入创建页面。
填写项目信息:
项目名称:给你的小程序起个名字(如“我的第一个小程序”)。
目录:选择或新建一个本地文件夹存放项目代码。
AppID:填入你在1.2步骤中获取的AppID(若只是学习体验,可选择“测试号”)。
开发模式:选择“小程序”。
后端服务:初学者建议选择“不使用云服务”。
点击“新建”,工具会自动生成一个包含基础代码的模板项目。
2.2 认识项目目录结构
项目创建成功后,你会看到类似以下的目录结构,理解它们至关重要:
```
my-miniprogram/
├── pages/ // 页面文件夹,每个页面一个子文件夹
│ ├── index/ // 首页
│ │ ├── index.js // 页面逻辑文件
│ │ ├── index.json // 页面配置文件
│ │ ├── index.wxml // 页面结构文件(类似HTML)
│ │ └── index.wxss // 页面样式文件(类似CSS)
│ └── logs/ // 示例页面(日志页)
├── utils/ // 公用工具类文件夹
│ └── util.js // 示例工具文件
├── app.js // 小程序全局逻辑文件
├── app.json // 小程序全局配置文件
├── app.wxss // 小程序全局样式文件
└── project.config.json // 项目个性化配置文件
```
第三步:编写代码——修改首页
3.1 编辑页面结构 (WXML)
打开 `pages/index/index.wxml` 文件,它定义了页面的骨架。我们修改一下内容:
```xml
```
`
`bindtap` 是点击事件绑定,`sayHello` 和 `goToLogs` 是在JS文件中定义的函数名。
`{{message}}` 是数据绑定语法,用于动态显示 `message` 变量的值。
3.2 编写页面逻辑 (JS)
打开 `pages/index/index.js` 文件,在 `Page` 函数中添加数据和函数:
```javascript
Page({
/
页面的初始数据
/
message: '等待你的操作...' // 初始化message数据
},
/
自定义函数:打招呼
/
sayHello: function {
this.setData({
message: '你好,世界!欢迎学习小程序开发!'
})
wx.showToast({
title: '打招呼成功',
icon: 'success'
})
},
/
自定义函数:跳转到日志页
/
goToLogs: function {
wx.navigateTo({
url: '/pages/logs/logs'
})
})
```
`data` 对象定义了页面初始数据。
`setData` 函数用于更新数据并触发视图重新渲染。
`wx.showToast` 和 `wx.navigateTo` 是微信小程序提供的API,分别用于显示消息提示框和页面跳转。
3.3 美化页面样式 (WXSS)
打开 `pages/index/index.wxss` 文件,添加样式:
```css
container {
padding: 40rpx;
display: flex;
flex-direction: column;
align-items: center;
min-height: 100vh;
background-color: f5f5f5;
title {
font-size: 40rpx;
color: 07c160;
margin-bottom: 60rpx;
font-weight: bold;
btn-area {
display: flex;
flex-direction: column;
width: 80%;
btn-area button {
margin-bottom: 30rpx;
tip {
margin-top: 60rpx;
font-size: 28rpx;
color: 888;
```
样式语法与CSS基本一致。
`rpx` 是响应式像素单位,能根据屏幕宽度自适应。
3.4 配置页面 (JSON)
打开 `pages/index/index.json` 文件,可以配置页面窗口样式,例如设置导航栏
```json
usingComponents": {},
navigationBarTitleText": "小程序首页
```
第四步:真机预览与调试
4.1 模拟器调试
开启者工具左侧是模拟器,右侧是代码编辑器和调试器。
在模拟器中点击按钮,查看效果,并可以在“Console”(控制台)、“Sources”(源码)、“Network”(网络)等面板进行调试。
4.2 真机预览
点击工具栏上的“预览”按钮。
用微信扫描弹出的二维码,即可在手机微信上实时体验小程序。
这是检查实际用户体验和样式兼容性的关键步骤。
第五步:上传代码与提交审核
5.1 上传代码
开发完成后,点击工具栏上的“上传”按钮。
填写版本号和项目备注(便于自己识别),点击“上传”。
上传的代码版本会出现在小程序管理后台的“版本管理”中。
5.2 提交审核
登录小程序管理后台,进入“版本管理”。
在“开发版本”中找到你刚上传的版本,点击“提交审核”。
根据要求填写审核信息,包括服务类目、测试账号(如果需要)、备注等。
提交后,等待微信官方审核(通常需要1-7个工作日)。
5.3 发布上线
审核通过后,在“审核版本”中,点击“发布”,即可将小程序正式上线,对所有微信用户开放。
通过以上五个步骤——准备账号、创建项目、编写代码、预览调试、上传发布——你已经完成了一个简单微信小程序的完整开发流程。核心在于掌握 WXML(结构)、WXSS(样式)、JS(逻辑)、JSON(配置) 这四种文件的分工与协作,并熟练使用开启者工具。建议初学者多动手修改示例代码,查阅官方文档中丰富的组件和API说明,从实现一个个小功能开始,逐步积累经验。小程序开发是一个实践性极强的过程,立刻开始你的第一个项目吧!






