唐山小程序开发环境搭建实录

上周帮唐山本地一个做建材批发的客户搭小程序环境，顺手把整个过程记下来。对方之前找过一家外包，代码丢过来连 README 都没有，node_modules 一装就报错，折腾两天没跑起来。这其实不是技术难，是环境这块没人讲清楚。今天就把我这边给唐山客户搭环境的标准流程写一遍，照着做能少走不少弯路。

先想清楚：你要的是哪种开发方式

小程序开发环境不是只有一条路。我一般让客户先选清楚，因为选错了后面改成本很高。

• 原生开发：微信官方开发者工具 + 原生 WXML/WXSS/JS，适合功能复杂、要用到蓝牙、定位、支付这类原生能力的项目。唐山这边做餐饮点餐、门店会员的小程序，我基本都走这条。
• 框架开发：uni-app 或 Taro，一套代码能出小程序和 App。如果客户后面还想上安卓/iOS，我会建议这个，唐山很多做本地生活服务的客户最后都要 App。
• 云开发：不买服务器，直接用微信云开发。小团队、预算紧的项目很合适，省掉备案和后端运维。

别一上来就装工具，先定这个。

基础环境：Node 和开发者工具

Node 建议装 LTS 版本，别追最新。我遇到过客户电脑上装了 20.x 的奇数版本，跑某些构建插件直接挂。装完用下面两条命令确认一下：

node -v
npm -v

然后是微信开发者工具，官网下载稳定版就行。安装时有个细节：路径别带中文和空格，唐山有客户把工具装在「D:\我的软件\微信开发」下面，后面 npm 构建一直报路径错误，换到纯英文目录就好了。

装好后登录，用微信扫码，注意这个微信号要和小程序后台的管理员或开发者权限对应上，不然创建项目时会提示无权限。

创建项目时最容易踩的坑

新建项目填 AppID，没有正式 AppID 可以先点「测试号」，但测试号不能真机预览支付、不能上线，只适合练手。正式项目一定用真实 AppID。

「不使用云服务」和「微信云开发」这个选项要选对。选了云开发，项目里会多出 cloudfunctions 目录，后端逻辑写在云函数里；如果后期想改回自建服务器，迁移不算轻松。我一般会问客户一句：你有没有现成的服务器和备案域名？没有就走云开发，有就走普通模式。

还有一个常被忽略的：项目目录不要放在 OneDrive、坚果云这类同步盘里。文件被同步进程锁住，编译时经常出现「文件读取失败」，排查起来很费时间。

依赖安装与真机调试

如果是原生项目，依赖很少，基本开箱即用。框架项目就要注意了：

npm install
npm run dev:mp-weixin

uni-app 编译产物在 dist/dev/mp-weixin，开发者工具要打开这个目录，而不是项目根目录。很多人第一次用会搞混，打开根目录后一片空白，以为环境坏了。

真机调试建议一开始就配。点工具右上角「预览」，手机扫码。这里有个唐山客户常问的问题：本地接口手机访问不到。原因是手机和电脑不在同一网段，或者接口写的是 localhost。把接口地址换成电脑局域网 IP，手机连同一个 WiFi 就行。上线前记得在微信后台配置 request 合法域名，这个不做，正式版接口全部失败。

给唐山本地客户的一点建议

环境搭好只是开始。我接触过不少唐山做小程序的朋友，卡住的地方往往不是代码，而是账号主体、类目资质、支付开通这些流程。比如做食品团购的，需要食品经营许可证；做教育培训的，类目审核比较严。这些在动手写代码前就该确认，不然环境搭得再顺，上线那一步照样卡住。

另外，如果你是把项目交给外包做，签合同前让对方把开发环境说明、依赖清单、构建命令写进交付物里。我见过太多「代码给了但跑不起来」的情况，最后只能重做。知码客这边接手的项目，交付时都会附一份环境说明，客户自己或换人接手都能直接跑起来。

环境这东西，搭一次理顺了，后面开发就顺。希望这篇对正在唐山做小程序的朋友有点用。