小程序制作视频教程：我踩过的坑与实战路线

做独立开发这几年，我录过几套小程序视频教程，也买过不少别人的课程。说实话，大部分教程的问题不在于讲得不好，而在于讲得太顺了——一路点下一步、一路复制粘贴，看完觉得会了，自己一动手就卡在环境配置上。这篇文章不推销课程，只聊聊我理解的「小程序制作视频教程」应该怎么选、怎么用，以及我自己录制时踩过的坑。

先想清楚：你要的是教程还是说明书

很多人搜「小程序制作视频教程」，其实心里想的是「怎么快速做出一个能上线的东西」。这里有个分岔：

• 看视频学原理：适合想长期做开发的人，重点看生命周期、数据绑定、组件通信这些底层逻辑。
• 看视频抄流程：适合只想做一个特定功能（比如点餐、预约）的人，重点是环境搭建、目录结构、发布审核的完整链路。

这两类教程的剪辑节奏完全不同。前者可以慢，可以反复讲一段代码；后者必须快，最好把「注册账号—下载工具—建项目—真机预览—提交审核」压缩进一集。你如果拿学原理的心态去看抄流程的教程，会觉得空洞；反过来拿抄流程的心态去看原理课，会觉得拖沓。先定位，再选课。

一套能落地的教程，应该包含哪些片段

我判断一套小程序视频教程值不值得看，会直接跳到几个关键节点检查：

1. 环境配置是否录了「出错现场」

真正有用的教程不会只展示成功路径。开发者工具版本不匹配、AppID 填错、网络代理导致登录失败，这些才是新手第一天就会遇到的。如果一集视频里连一次报错都没出现，我基本会怀疑它被剪得太干净了。

2. 是否讲清楚页面跳转与数据传递

小程序里最容易出问题的不是写页面，而是页面之间怎么传参、返回时怎么刷新。教程里如果只演示 wx.navigateTo，却不讲 onLoad 和 onShow 的区别，后面一定踩坑。

// 传参不是重点，接收和刷新才是
wx.navigateTo({
  url: '/pages/detail/detail?id=' + id
})

// detail 页
Page({
  data: { info: null },
  onLoad(options) {
    this.fetchDetail(options.id)
  },
  onShow() {
    // 从编辑页返回时，这里才是刷新数据的地方
  }
})

3. 有没有真机调试和审核环节

模拟器跑通不等于上线。真机上的样式差异、域名白名单、隐私协议配置，这些内容如果教程里完全没有，那它只能算「demo 教程」，不算「制作教程」。

我自己录教程时踩过的三个坑

坑一：语速和操作速度不匹配

第一套视频我按正常语速讲，结果观众反馈「跟不上鼠标」。后来改成操作放慢、关键代码单独放大停留三秒，完播率明显好转。视频教程的节奏不是讲者舒服，而是看者能暂停在正确的位置。

坑二：代码在视频里，不在配套资料里

只靠暂停截图抄代码，体验极差。现在我每集都配一份可运行的源码，视频里只讲「为什么这么写」，具体字符让观众去对照文件。这样视频时长能压缩三分之一，信息密度反而更高。

坑三：只讲功能，不讲取舍

比如做一个列表页，用普通 view 循环也能做，用 scroll-view 也能做。教程如果只给一种写法，观众就学不到判断标准。我后来会在结尾加一段「这里为什么不用另一种方案」，哪怕只有三十秒，价值比多写十个页面都大。

看教程的正确姿势

1. 先倍速过一遍全貌，知道这套教程覆盖到哪一步，别一集一集死磕。
2. 第二遍动手跟做，但故意改一点需求，比如把「商品列表」改成「文章列表」，检验自己是不是真懂了。
3. 卡住时先查官方文档，教程只是引路，API 的细节永远以文档为准。
4. 做完立刻提交一次体验版，审核流程越早走一遍越好，别等全部做完才发现类目选错。

教程能帮你少走弯路，但绕不开的路还是得自己走一遍。看十套视频，不如完整上线一个小程序。

写在最后

「小程序制作视频教程」这个关键词背后，其实是两种人：一种想学一门手艺，一种想解决一个具体问题。前者别贪快，后者别求全。如果你正准备自己录教程，我的建议是——先把自己做项目时卡住的那几个瞬间记下来，那些才是观众最想看的片段，而不是顺利跑通的那一段。