上周有个做小程序外包的朋友把项目做完了，客户要源码。他直接把项目文件夹打了个压缩包发过去，客户那边用微信开发者工具导入，弹了一堆错——AppID不对、云函数没配置、第三方插件没注册。客户怀疑他给的不是完整源码，他也很冤枉：明明整个文件夹都打包了，为什么到了客户手里就缺这缺那？
这个问题很多人遇到过。微信开发者工具里涉及"代码导出"的操作至少有三种——导出项目、预览、上传——三种方式的产物完全不同，搞混了轻则交付被拒，重则源码交接出大问题。下面把这三种方式的区别、每种产物的用途、以及源码交接给客户时哪些文件必须带、哪些不能带，一次说清楚。
微信开发者工具里三种和"代码导出"相关的操作，产物完全不同
| 1 | 导出项目（右键→导出项目）：把整个项目文件夹打包成zip，包含所有源码、配置文件、node_modules（可选），这是唯一能直接交给别人继续开发的格式 |
| 2 | 预览（工具栏预览按钮）：编译当前项目，把编译后的代码包上传到微信服务器，生成一个临时二维码，只能扫码在手机上预览效果，拿不到源码 |
| 3 | 上传（工具栏上传按钮）：编译并上传代码到微信后台，用于提交体验版或审核版，在微信后台能看到版本号，但也拿不到原始源码 |
一、三种"导出代码"方式的底层区别
很多人以为"预览"和"上传"就是导出代码，这是误解的根源。预览和上传本质上做的是同一件事：把源码编译成小程序运行时需要的格式（wxml→编译后页面、wxss→编译后样式、js→压缩打包），然后上传到微信服务器。这个过程完成后，你本地拿不到任何东西，代码在微信的服务器上。而"导出项目"是把本地源码文件夹原样打包，不经过编译。
| 操作方式 | 操作入口 | 产出物 | 产物在哪 | 能给别人用吗 |
|---|---|---|---|---|
| 导出项目 | 项目列表页，右键项目名 → "导出项目…" | 完整源码的.zip压缩包 | 你选择的本地路径 | 可以，对方解压后用开发者工具导入即可 |
| 预览 | 工具栏"预览"按钮 | 一个临时二维码 | 微信服务器，本地不留 | 不可以，只能扫码看效果，有效期短 |
| 上传 | 工具栏"上传"按钮 | 一个版本号，存在微信后台 | 微信后台，本地不留 | 不可以，只能用来提交审核或设为体验版 |
| 直接复制文件夹 | 直接在文件资源管理器复制项目目录 | 源码文件夹的完整副本 | 你粘贴的目标路径 | 可以，但有注意事项（见下文） |
一句话总结：要给客户源码 → 用"导出项目"或直接复制项目文件夹。要给客户看效果 → 用"预览"生成二维码让客户扫码。要提交审核 → 用"上传"把代码推到微信后台。三种操作的目的完全不同，别搞混。
二、"导出项目"的详细操作步骤
这是最常用的导出源码的方式，也是把项目交接给客户或同事的标准做法。操作不复杂，但有几个选项的勾选会影响导出结果。
第一步：打开项目列表
打开微信开发者工具，如果当前已经打开了某个项目，先关闭当前项目回到项目列表页。项目列表页会显示你最近打开过的所有小程序项目，每个项目卡片上有项目名称、AppID、最近打开时间。
第二步：右键导出
在要导出的项目卡片上点鼠标右键，在弹出的菜单中选择"导出项目…"。注意：是在项目列表页右键，不是在代码编辑页。如果你已经在项目里了，先点左上角的"小程序开发"回到列表页。
第三步：选择导出选项
弹出一个对话框，有三个选项可以勾选：①导出node_modules（默认不勾选）②导出时包含云函数本地依赖 ③导出时清理项目缓存文件。如果是给客户，建议不勾选node_modules（体积大，对方npm install就能装回来），但要勾选"清理缓存文件"。
第四步：保存和验证
选择保存路径，点击确定，工具会自动打包成.zip文件。拿到zip后不要直接发给客户——先自己解压到另一个文件夹，用开发者工具"导入项目"试一下，看能不能正常打开、编译、预览。确认没问题了再发。
三、直接复制文件夹和"导出项目"的细微差别
很多人嫌导出项目的步骤麻烦，直接在文件资源管理器里找到小程序项目文件夹，复制粘贴发给客户。这个方法大部分情况下没问题，但有几个细节容易漏掉，导致对方导入时报错。
最关键的文件是project.config.json。这个文件在项目根目录下，记录了项目的AppID、项目名称、编译设置（ES6转ES5、增强编译、不校验合法域名等选项）。如果没有这个文件，对方用开发者工具导入项目时，AppID字段是空的，需要手动填写，而且之前设置好的编译选项全部丢失。微信开发者工具的"导出项目"功能会自动确保这个文件被包含在zip里。
另一个容易漏的是project.private.config.json。这个文件也在根目录下，存储的是开发者个人的本地配置（比如是否开启自动编译、编辑器字体大小等），不是项目运行必需的，但如果你不导出这个文件，对方打开项目后需要重新配置一遍开发环境。
| 文件/文件夹 | 作用 | 必须给吗 | 说明 |
|---|---|---|---|
| app.js / app.json / app.wxss | 小程序全局入口文件 | 必须 | app.js和app.json是小程序必需的，缺了项目跑不起来 |
| pages文件夹 | 所有页面文件 | 必须 | 包含每个页面的wxml、wxss、js、json四个文件 |
| project.config.json | 项目配置文件（AppID、编译设置等） | 必须 | 缺了对方导入时AppID为空，这是最常见的交付翻车原因 |
| project.private.config.json | 开发者个人本地配置 | 建议给 | 不给也能跑，但对方要重新配开发环境。如果包含敏感信息建议删了再给 |
| cloudfunctions文件夹 | 云函数代码 | 如果用了云开发则必须 | 每个云函数子文件夹里的node_modules可以不导出，让对方npm install |
| node_modules文件夹 | npm依赖包 | 不用给 | 体积大，对方拿到源码后执行npm install即可自动安装 |
| miniprogram_npm文件夹 | 小程序npm构建产物 | 不用给 | 对方导入后点"工具→构建npm"会自动生成 |
一个新手常犯的错误：直接用微信开发者工具的"上传"功能把代码推到后台，然后跟客户说"代码已经传上去了"。上传到微信后台的是编译后的运行包，不是源码。客户拿不到你的wxml、wxss、js源文件，如果以后想换人维护或者做二次开发，只能从头重写。源码交接必须走"导出项目"或直接复制项目文件夹的方式。
四、源码交接给客户时的注意事项清单
小程序源码交接不只是把代码打包发过去那么简单。如果交接不完整或者遗漏了关键信息，客户拿到源码也用不起来。以下是交付源码时必须配套提供的四样东西：
AppID和小程序后台权限
源码里的AppID要和微信小程序后台一致。如果项目是你在自己的账号下创建的，需要把客户添加为小程序的项目成员（在微信公众平台→成员管理→添加开发者），给"开发者"权限。如果是直接转让所有权，需要客户的小程序后台把AppID给你或者你把项目迁移过去。
服务器域名配置清单
小程序的所有网络请求需要在微信后台配置合法域名（request、uploadFile、downloadFile、socket等）。把项目中用到的所有API域名整理成一个清单，截图或文档附在源码包里，客户在后台照着配置就行。漏了这一步，客户运行项目时所有网络请求都报错。
第三方插件和依赖说明
如果项目使用了微信第三方插件（如地图插件、直播插件等），在app.json的plugins字段里声明了，客户也需要在自己的小程序后台→设置→第三方服务→插件管理中申请对应的插件使用权。没有这一步，编译会报插件未授权。
云开发环境ID和配置
如果用了微信云开发，源码中app.js里会有云环境ID（env字段）。客户需要在自己的云开发控制台创建对应环境，或者你把自己的云环境共享给客户。云函数需要单独部署，数据库集合结构需要提供导出或建表脚本。
给客户的README文档建议包含：①项目技术栈说明（用了什么框架/UI库/npm包）②本地开发环境要求（Node版本、微信开发者工具版本）③如何安装依赖（npm install + 构建npm）④服务器域名配置清单⑤云函数部署说明⑥常见问题排查（编译报错怎么办、预览白屏怎么办）。这份文档花半小时写，能省掉后面无数次远程协助。
五、小程序代码不能反编译，但有些事要知道
经常有人问：小程序提交审核后，别人能不能从微信后台拿到我的源码？答案是不能。微信小程序提交到后台的代码是经过编译和压缩的，wxml和wxss被转换成了渲染层的指令格式，原始代码结构不可逆。即使有人通过各种手段拿到了编译后的代码包，也无法还原成可读、可维护的源码。
但这不意味着源码可以随意传播。源码是你最核心的数字资产之一，交接时建议在合同里明确源码的使用范围（仅用于该项目、不得转售或复用）和知识产权归属。如果是外包项目，验收时除了导出源码，还要确认项目里没有隐藏的后门或未授权的第三方请求。
如果你同时在维护多个小程序项目，代码管理和版本控制是一个容易被忽略的问题。每个小程序的源码、配置文件、云函数、第三方依赖都需要独立管理，用Git做版本控制是最基本的要求。如果多个小程序共享部分业务逻辑，建议把公共模块抽成独立的npm包或git submodule，而不是在每个项目里复制一份——改一个地方要改十几个项目是效率杀手。
一个小程序开发者的效率技巧：如果同时做小程序和配套的Web端内容（比如帮助中心、使用教程、落地页等），可以考虑用UC建站系统来管理Web端内容。WP底层+HTML直出对搜索引擎天然友好，配合百度API和IndexNow双通道推送，新内容能快速被收录。独立部署保证了每个小程序的Web端内容和品牌独立。这样小程序做功能、Web端做内容引流，两端各司其职，不用在小程序里塞一整套内容管理系统。
说回导出代码这件事，核心就三条：源码交接用"导出项目"或复制文件夹，别漏project.config.json；预览和上传不是导出，拿不到源码；交付源码时附带AppID权限、域名清单、插件授权和README文档。把这三点做到，小程序源码交接基本不会出大问题。至于那些跟你说"源码在我这你放心"的开发公司——合同里没写源码交付的，都不叫放心。
