wechat-miniprogram-examples部署发布指南：从sitemap配置到小程序正式上线全流程

wechat-miniprogram-examples部署发布指南：从sitemap配置到小程序正式上线全流程

【免费下载链接】wechat-miniprogram-examplesWeChat mini program examples. 微信小程序示例项目地址: https://gitcode.com/gh_mirrors/we/wechat-miniprogram-examples

微信小程序部署发布是每位新手开发者从"写完代码"到"用户能用"必须跨过的一关。本文以开源项目wechat-miniprogram-examples（微信小程序示例合集）为实战素材，带你完整走一遍小程序上线全流程：从获取 AppID、配置project.config.json、理解sitemap 配置规则，到微信开发者工具上传代码、提交审核直至正式发布。全程零门槛，跟着做就能把示例项目真正跑起来。

一、为什么用它练手小程序部署？🤔

这个项目收录了三个经典微信小程序示例，覆盖了上线前几乎全部关键知识点：

每个示例都自带完整的app.json、sitemap.json、project.config.json，结构规范、代码简洁，非常适合用来熟悉小程序发布配置。需要源码时，用以下命令克隆仓库：

git clone https://gitcode.com/gh_mirrors/we/wechat-miniprogram-examples

二、部署前的关键准备：获取小程序 AppID 🔑

项目 README 明确提醒：每个示例都没有配置appid，所以第一件事就是补上它。打开 mp.weixin.qq.com 注册小程序账号，在"开发管理 → 开发设置"中即可看到自己的 AppID。

拿到 AppID 后，打开任意示例的project.config.json（比如DouBanBookApp/project.config.json），把空的"appid": ""填上。这一步不完成，小程序真机预览和部分 API 都无法正常工作，更无法提交审核上线。

三、最快配置方法：project.config.json 关键字段

project.config.json是微信开发者工具的项目配置文件，部署发布前建议核对这几个字段：

• compileType：保持"miniprogram"，代表普通小程序项目
• libVersion：基础库版本，建议更新到较新版本
• urlCheck：开发时可设为false绕过域名校验，上线前务必改回true并配置合法域名
• appid：上一节填写的 AppID

四、小程序 sitemap 配置教程：控制页面收录 🔍

sitemap.json是很多新手忽略、却在小程序上线后影响搜索收录的重要文件。每个示例都自带一份，例如DouBanBookApp/sitemap.json内容如下：

{ "desc": "关于本文件的更多信息，请参考微信官方文档", "rules": [{ "action": "allow", "page": "*" }] }

这条规则的含义是"允许所有页面被微信索引"。如果你想让部分页面不被收录，可以这样写：

{ "rules": [ { "action": "allow", "page": "pages/index/index" }, { "action": "disallow", "page": "pages/detail/detail" } ] }

注意事项：sitemapLocation字段必须在app.json中声明指向sitemap.json（三个示例均已配置好），否则 sitemap 配置不生效。默认规则是全部允许，隐私敏感页面记得显式disallow。

五、app.json：页面注册与窗口样式的最后检查

上线前请打开app.json逐一确认：

1. 页面注册：pages数组首项即小程序启动首页，确认无误
2. 窗口配置：window.navigationBarTitleText是页面标题，会直接影响用户观感
3. sitemapLocation：确保指向你的 sitemap 配置文件

以ZhiHuDaily/app.json为例，它注册了 6 个页面并设置了蓝色导航栏，结构非常标准，适合对照检查自己的项目。

六、微信开发者工具上传代码与版本管理 🚀

配置完成后，用微信开发者工具打开对应示例目录：

1. 点击右上角"上传"，填写版本号和备注，代码将提交到小程序后台
2. 进入小程序后台"版本管理"，将刚上传的版本设为体验版，先扫码真机测试
3. 测试通过后，点击"提交审核"，填写功能页面与测试账号等信息

七、提交审核与正式发布全流程

提交审核后一般 1～3 个工作日会有结果，通过后点击"发布"即可正式上线。整个小程序正式上线流程可以总结为：

配置 AppID → 修改 project.config.json → 配置 sitemap.json → 上传代码 → 设为体验版 → 真机测试 → 提交审核 → 审核通过 → 发布上线

八、三个示例的部署效果预览 📱

用本项目练手时，你可以对照下面的效果图验证部署是否成功：

九、上线避坑清单 ✅

• 域名校验：正式环境必须使用 HTTPS 且在小程序后台配置 request 合法域名
• AppID 必填：空 AppID 无法真机预览和提审
• sitemap 规则：注意page路径要与app.json完全一致
• 基础库版本：过低的libVersion会导致新 API 不可用
• 体验版先行：务必先真机验证再提交审核，避免浪费审核次数

按照这份微信小程序部署发布指南，从 sitemap 配置到正式上线，你已经掌握了完整链路。赶紧打开 wechat-miniprogram-examples，把第一个小程序发布出去吧！🎉

【免费下载链接】wechat-miniprogram-examplesWeChat mini program examples. 微信小程序示例项目地址: https://gitcode.com/gh_mirrors/we/wechat-miniprogram-examples