要回答“编写小程序的资料有哪些”，如果只丢给你一堆官方文档链接，那和搜索引擎没什么区别。真正动手写过小程序的人都知道，资料不是越多越好，而是“在哪个阶段、遇到什么问题、去哪找什么资料”才是关键。我把这些资料拆成四个维度来讲，每个维度都对应你实际写代码时会遇到的真实场景。

一、官方文档——不是让你从头读到尾，而是当字典用

微信小程序官方文档（developers.weixin.qq.com/miniprogram/dev/）是所有资料的基石。但一进去就被目录吓退——组件、API、云开发、工具……几百个页面。我的建议是：别试图“学完”它。

你需要重点看的是这三块：
1. 组件列表 —— 比如 view、text、image、scroll-view、swiper。这些是搭积木的零件。遇到“怎么让图片轮播”这种问题时，直接去搜 swiper 的示例代码，复制过来改改就能用。
2. API 参考 —— 比如 wx.request 发网络请求、wx.getUserProfile 获取用户信息。千万别背参数，记住一个技巧：在微信开发者工具里，输入 wx. 就会自动弹出提示，点进去能看到完整参数说明。
3. 云开发文档 —— 如果你不想自己搭服务器，就用微信的云开发。它的数据库、云函数、存储文档非常详细，而且有“快速开始”教程，跟着做十分钟就能跑通一个带数据库的小程序。

举个实际例子：你写一个“用户登录”功能，去官方文档搜“登录流程”，它会告诉你用 wx.login 获取临时 code，然后传给后端。但如果你用的是云开发，文档里有现成的云函数模板，直接调用 cloud.openapi 就能拿到用户 openid，省去自己写鉴权的麻烦。

---

二、社区与问答——解决你“卡住”的最后一公里

官方文档只能告诉你“这个API有什么参数”，但解决不了“为什么我的 setData 页面没刷新”这种具体问题。这时候需要社区资料。

微信官方社区（developers.weixin.qq.com/community/）是首选，因为回答的人很多是微信团队的技术支持。但它的搜索不太好用，建议用 “关键词 + site:developers.weixin.qq.com” 在百度里搜，比如“scroll-view 不滚动 site:developers.weixin.qq.com”。

Stack Overflow 上也有不少微信小程序问题，但因为是英文社区，回答质量参差不齐。我一般只用来查“WeChat miniprogram + 某个英文关键词”，比如“WeChat miniprogram upload image”，因为微信的文档有中文语境，老外遇到的问题往往更基础。

还有一个容易被忽略的资料库：GitHub 上的 issue 区。比如你用的某个第三方组件库（比如 WeUI、Vant Weapp），去它的 GitHub 仓库搜 issue，很多别人踩过的坑和解决方案都在评论区里。比如“Vant Weapp 的 Field 组件在 iOS 上键盘弹起时页面被顶上去”，这个问题官方文档没写，但 issue 里有人贴了修复代码。

---

三、视频教程与实战项目——别只看，要跟着敲

文字资料容易让人“眼睛会了手不会”。视频教程的好处是能看到操作细节，比如怎么在开发者工具里调试网络请求、怎么打断点。

B站上搜“微信小程序实战”能出来一大堆，但质量参差不齐。我筛选的标准是：看它是不是“从零到一”完整项目。很多教程只讲几个页面，不涉及登录、支付、云函数这些真实场景。真正有用的视频，应该包含：
- 项目创建与目录结构设计
- 用户授权与登录流程
- 数据请求与渲染（包括加载状态和错误处理）
- 发布上线流程（包括审核注意事项）

推荐一个经典案例：“仿豆瓣电影”小程序。豆瓣的 API 是开放的，你可以用它练习列表页、详情页、搜索、评分功能。跟着敲一遍，基本能覆盖小程序 80% 的常用能力。敲的时候注意：不要复制粘贴，每个字母都自己打，遇到报错就自己查，这样才会记住。

另外，微信官方出的“小程序开发实战”电子书（在微信开放社区可以下载）比很多视频靠谱。它不讲废话，直接给你一个完整的“备忘录”小程序代码，从页面布局到云函数全都有，而且每段代码都有注释说明“为什么这么写”。

---

四、工具与辅助资料——让你少写一半代码

写小程序时，很多重复劳动可以用工具代替，这些也属于“资料”的一部分：

1. 代码片段托管平台 —— 微信官方有一个“代码片段”功能，在开发者工具里可以直接创建并分享。比如你写了一个“图片压缩”功能，可以把它存成代码片段，下次另一个项目直接导入就能用。很多开发者会在社区分享自己的代码片段，比如“自定义导航栏”、“下拉刷新封装”，搜一下就能找到。

2. 设计资源 —— 小程序的设计规范和组件库。微信官方提供了 WeUI 组件库，完全符合微信的设计规范，直接用它的样式，页面看起来就“像微信原生”的。还有 IconFont（阿里巴巴矢量图标库），小程序里可以直接引入，不用自己画图标。

3. 调试工具 —— 微信开发者工具自带的 “真机调试” 和 “性能面板” 是必学的。写完了才发现“怎么页面这么卡”，其实用性能面板看渲染时间、setData 频率，马上就能定位问题。另外，Charles 或 Fiddler 可以用来抓包，看小程序发的网络请求是不是正确，这在调试支付、登录时特别有用。

4. 第三方服务文档 —— 如果你的小程序要用到地图（腾讯地图 SDK）、支付（微信支付）、推送（极光推送），这些服务的官方文档也要看。但注意：不要一上来就看全部文档，而是先看“快速接入”章节，跑通示例代码，再根据需求看具体 API。

---

一个实际的学习路径建议

假设你是个新手，想把资料用起来，可以这样操作：

第一步：打开微信官方文档的“快速开始”，用工具创建一个默认模板项目，跑起来看看。
第二步：找一个“仿豆瓣电影”的完整视频教程，跟着敲一遍，遇到不懂的 API 去官方文档查，遇到报错去社区搜。
第三步：把项目里的登录、请求、渲染部分抽出来，做成自己的代码片段，存到工具里。
第四步：自己构思一个小项目（比如“记账本”），用之前学的资料独立完成，卡住时优先用社区搜索和 GitHub issue。

这样走下来，你接触到的资料就不再是零散的链接，而是围绕“解决问题”组织起来的知识网络。资料本身不会让你学会写小程序，但知道“什么时候该用什么资料”，才是真正的能力。