微信小程序开发全流程准备工作指南（2025最新版）

最新推荐文章于 2025-06-07 18:31:39 发布

原创最新推荐文章于 2025-06-07 18:31:39 发布 · 4.6k 阅读

32 ·

CC 4.0 BY-SA版权

文章标签：

#前端 #微信小程序 #小程序

从账号注册到代码上线的完整避坑指南

🔐 一、账号注册与认证：小程序的“身份证”

1. 注册类型选择

个人开发者：仅需身份证，无法使用支付、直播等商业功能
企业/个体工商户：需营业执照+法人身份证，必须进行微信认证（300元/年）

2. 注册步骤

访问微信公众平台点击“立即注册”
使用未绑定过微信服务的邮箱（建议企业邮箱）
完成邮箱验证后选择主体类型（企业主体不可更改）
企业用户需提交：
- 营业执照扫描件
- 法人身份证正反面
- 对公账户信息

3. 微信认证关键点

费用：300元/年（审核失败不退）
耗时：1-3个工作日
认证后权限：微信支付、用户手机号获取、高级地理位置等接口

💡 避坑提示：个人开发者想做电商？立即申请个体工商户执照！成本仅需几十元，开通时间1-2天。

🌐 二、域名与服务器准备：小程序的“家”

1. 域名注册备案

注册平台：阿里云/腾讯云（首年约50元）
必做操作：
- 实名认证（企业需营业执照）
- ICP备案（需13-20个工作日）
- 下载域名证书

2. **服务器选购指南

类型	价格	适用场景	推荐厂商
虚拟主机	100元/年	静态展示类小程序	景安（免费虚拟主机）
云服务器	500元+/年	电商/高并发场景	阿里云/腾讯云学生机（10元/月）
VPS	300元+/年	自定义环境需求	腾讯云轻量应用服务器

3. 环境配置核心三要素

端口开放：

# 检测命令（Windows）
netstat -ano | findstr 443
telnet yourdomain.com 443

SSL证书：
- 免费获取：腾讯云/阿里云控制台申请DV证书
- 部署要求：Tomcat需用Tomcat版本证书
HTTPS强制配置：小程序所有请求必须走HTTPS协议

💻 三、开发环境搭建

1. 必备工具

微信开发者工具（最新版支持暗黑模式）
代码编辑器推荐：VSCode + WXML插件

2. 关键配置信息获取

登录小程序后台 →【开发】→【开发设置】
获取：
- AppID（小程序唯一标识）
- AppSecret（务必保存！ 后台只显示一次）
配置服务器域名：
- request合法域名
- uploadFile合法域名
- downloadFile合法域名

🛠️ 四、小程序项目初始化

1. **目录结构解析

├── app.js               # 全局逻辑（生命周期管理）
├── app.json             # 全局配置（页面路由/tabBar）
├── app.wxss             # 全局样式
├── pages                # 页面目录
│   ├── index
│   │   ├── index.js     # 页面逻辑
│   │   ├── index.json   # 页面配置
│   │   ├── index.wxml   # 页面结构
│   │   └── index.wxss   # 页面样式
└── project.config.json  # 开发工具配置

2. **核心配置文件详解

app.json 关键配置项：

{
  "pages": ["pages/index/index", "pages/logs/logs"],
  "window": {
    "navigationBarTitleText": "我的小程序",
    "enablePullDownRefresh": true
  },
  "tabBar": {
    "list": [{
      "pagePath": "pages/index/index",
      "text": "首页",
      "iconPath": "static/home.png",
      "selectedIconPath": "static/home-active.png"
    }]
  }
}

⚠️ 黄金法则：pages数组中首个页面为小程序启动页，新建页面必须在此注册。

🚀 五、上线前关键准备

1. 支付功能对接（企业必看）

申请微信支付商户号（1-3天审核）
小程序后台绑定商户号

集成支付API

wx.requestPayment({
  timeStamp: '',
  nonceStr: '',
  package: '',
  signType: 'MD5',
  paySign: '',
  success(res) { /* 支付成功 */ }
})

2. 提审避坑清单

审核失败原因	解决方案
类目选择错误	电商选“商家自营”，餐饮选“餐饮服务”
未配置隐私协议	在`app.json`添加`"privacy": { "prompt": "accept" }`
功能不完整	提供测试账号（账号/密码放在简介框）
诱导分享	删除“转发得红包”等文案

3. 发布流程

开发者工具点击【上传】（版本号命名规范：v1.0.0）
后台提交审核（加急通道：企业认证用户3小时内审结）
审核通过后手动点击【发布】

💰 费用明细总表（企业认证方案）

项目	费用	备注
微信认证	300元/年	腾讯官方收取
域名注册	50元/年	.com后缀
云服务器	500元+/年	入门配置1核2G
SSL证书	0元	使用免费DV证书
支付费率	0.6%/笔	微信支付手续费

⚡ 终极避坑指南（血泪经验）

域名双备案陷阱：工信部备案后必须在小程序后台二次备案（路径：设置→备案）
缓存超限：localStorage 上限10MB，重要数据建议服务器存储
页面层级：导航栈不超过5层，超深层级用redirectTo替代navigateTo
版本兼容：低版本iOS不支持Promise，务必用async/await需添加polyfill

最新政策提示（2025年6月）：微信现已推行 “快速备案通道” ，企业用户完成主体认证后，域名备案审核时间缩短至3个工作日。建议开发者优先使用微信云开发方案，可免去服务器配置和HTTPS证书部署流程。

本指南整合微信官方文档及一线开发者实战经验，点赞收藏可随时查阅最新更新！如有疑问欢迎评论区交流～