邯郸做小程序，开发环境别踩这些坑

我是知码客，在邯郸做小程序和 APP 开发这几年，被问得最多的问题不是“多少钱”，而是“我这电脑上装个啥就能开始写了”。很多人以为开发环境是程序员自己的事，其实它直接决定了项目后面顺不顺。今天就把我这边实际在用的环境配置聊一聊，顺便说说邯郸本地客户常踩的几个坑。

一、别一上来就装一堆工具

新手最容易犯的毛病，是打开教程视频跟着装：Node、HBuilderX、VS Code、各种脚手架，装完发现哪个都不熟。我的建议是先想清楚做哪种小程序：

• 只做微信小程序：微信开发者工具 + VS Code 就够了，前者负责调试和预览，后者负责写代码。
• 要同时出支付宝、抖音端：再考虑 uni-app 这类跨端框架，但别一开始就上，先把原生跑通。
• 后端要不要自己写：如果只是展示、预约、简单下单，微信云开发能省掉服务器这一大块，邯郸不少本地商家项目我就是这么做的。

工具装多了不是本事，能稳定跑起来才是。我见过有客户自己折腾了两周环境，最后项目还没动一行业务代码。

二、微信开发者工具的正确打开方式

下载安装没什么好说的，关键是几个设置，很多邯郸的客户把项目发给我时，这些都没弄对：

• AppID 别用测试号凑合：测试号不能真机预览、不能调支付，正式项目一开始就注册好小程序账号，把 AppID 填进去。
• 打开“不校验合法域名”只在开发阶段用：上线前一定关掉，否则真机上接口全挂，这是最常见的上线翻车点。
• 本地设置里勾上“将 JS 编译成 ES5”：老机型兼容性会好很多，尤其是本地一些用户还在用几年前的安卓机。
• 详情里的“调试基础库”别追最新：选一个稳定版本，团队统一，不然你这边好好的，同事那边报错。

真机调试这个功能要常用。模拟器上排版好看不代表真机好看，特别是带刘海屏、折叠屏的机型，我一般会拿两三种机子过一遍。

三、代码编辑器与插件

我主力用 VS Code，插件不用多，几个够用：

WXML - Language Service      // wxml 语法高亮与提示
minapp                       // 小程序标签补全
ESLint                       // 统一代码风格
Prettier                     // 格式化
GitLens                      // 看提交历史

这里多说一句版本管理。哪怕是一个人做项目，也建议用 Git，本地建个仓库就行。邯郸有客户找我接手别人做了一半的项目，结果对方只给了个压缩包，没有提交记录，改起来像考古。有 Git 历史，至少知道哪块动过。

四、云开发适合哪些本地场景

微信云开发这几年成熟不少，我给它总结的适用边界是：

• 适合：预约登记、活动报名、简单商城、内容展示、内部管理工具。数据库、存储、云函数一套配齐，不用买服务器、不用备案。
• 不太适合：高并发秒杀、需要复杂事务的业务、对数据迁移有强要求的系统。

给邯郸本地一家做社区服务的客户做过报名小程序，用云开发两周就上线了，成本比传统服务器方案低不少。但也有客户后期想接自己的会员系统，云开发的数据库迁移就得花点功夫，所以选型时要把后路想清楚。

五、本地开发常被忽略的两件事

1. 网络与代理

公司网络如果走了统一代理，开发者工具请求接口可能一直转圈。排查顺序：先看工具里“网络”面板，再看系统代理，最后看域名有没有配到后台白名单。这个问题不复杂，但第一次遇到能耗掉半天。

2. 多人协作的目录规范

两三个人一起做，目录结构最好一开始就定好：页面放 pages，组件放 components，工具函数放 utils，接口统一收在一个文件里。邯郸本地团队规模普遍不大，规范不用搞太重，但要有，不然合并代码时冲突能让人崩溃。

六、上线前的环境检查清单

我这边交付前会过一遍：

1. 合法域名是否已在后台配置，HTTPS 证书是否有效；
2. “不校验合法域名”是否已关闭；
3. 真机预览是否正常，支付、登录流程是否走通；
4. 体验版是否发给客户确认，版本号是否写清楚；
5. 基础库版本是否在后台设置为兼容范围。

这几条看着琐碎，但每一条我都见过真实翻车。小程序上线不像网页，改完刷新就行，它有审核、有版本，环境没弄对，审核过了用户也用不了。

写在最后

开发环境这件事，说到底是把不确定性提前消灭掉。工具装对、配置调好、规范定下，后面写业务逻辑才顺。我是知码客，在邯郸做小程序和 APP 开发，平时也接本地商家的定制需求。如果你正打算做个小程序，或者手里有个项目环境一直跑不顺，欢迎聊聊，很多时候问题没你想的那么大。