2026/9/8 5:10:46
FEATURED · 精选文章 
这两年找我咨询个人开发者能不能做微信小游戏的人特别多多数人第一反应都是“要不先注册个公司”“要不找个中介买个版号”但如果你做的是纯休闲、没有虚拟支付能力的游戏个人主体完全可以自己跑完 Unity 到微信小游戏的上架全流程而且确实有免版号通道。这篇文章把我自己反复跑了多遍的完整流程、踩过的坑、以及哪些环节容易卡住一次性整理出来建议收藏后再看内容比较长但每一条都值得落地。先说结论个人主体接入微信小游戏核心优势是门槛低不需要对公账户、不需要企业认证费只要能通过微信实名验证就能注册而限制也很明显不能开通虚拟支付也就是游戏内不能有充值、购买金币这类功能同时类目选择上不占优势。所以适合个人主体做的基本就是纯广告变现的休闲游戏、工具型小游戏、互动益智类产品。理解了这一层后面所有流程其实都已经有了明确边界照着做就行。1. 整体思路先理清个人主体到底能做什么、免版号又是什么1.1 个人主体与企业的差异很多开发者一听到“微信小游戏”就以为必须有个营业执照或者是被网上那些代办公司给绕晕了。实际上微信公众平台是支持个人主体注册小游戏账号的注册入口选“小游戏”主体类型选“个人”后面就是邮箱、身份证、管理员微信扫码这些常规操作不需要对公账户验证。个人主体真正要接受的限制是支付能力。微信小游戏个人主体无法开通虚拟支付也就是说游戏里不能有“6元买钻石”“18元解锁关卡”这种内购项目。但平台保留了广告变现的路径也就是流量主能力达到一定的活跃门槛后可以接入微信广告用户看完激励视频你就有收入。这一点对大多数个人开发者来说已经够了你一个没有发行资源的小团队想做内购本来也很难搞定版号和货架。除了支付个人主体在开放接口上也有一些差异比如某些用户隐私接口、数据能力会有更严格的申请条件。但基础能力比如登录、分享、排行榜、云存储、广告组件都是有的不影响Unity游戏接入。1.2 免版号的实际含义与合规前提“免版号”这个词在圈子里容易引起误解它不是说你什么游戏都能直接发而是建立在“不涉及虚拟支付、不涉及需要前置审批的题材”这个前提下。简单说如果你的小游戏没有充值入口不搞棋牌、彩票、金融这类需要专门资质的题材而是休闲合成、答题、模拟经营、交互叙事这类内容微信公众平台的后台是可以引导你走免版号提交的。实际操作中个人主体在提交审核时后台会让你确认游戏是否涉及经营也就是有没有虚拟支付。选“否”之后正常情况不需要上传版号只要游戏内容合规、隐私保护完善审核就可以走量。这里要注意两点一是平台政策随时可能调整提审前一定要看一眼最新的《微信小游戏运营规范》和后台实际问询二是即使免版号你的游戏名称、图标、简介、截图、隐私保护指引这些基础资料也必须齐全不能抱着“反正没版号审核会松”的心态。我自己给朋友做过几次上线支持碰到最多的驳回原因是隐私保护指引没有写清楚、游戏截图带第三方水印、描述里出现“充值”“支付”这类敏感词。这些在个人主体上尤其容易踩因为很多模板都是从企业主体教程里复制过来的信息没有改干净。1.3 完整流程全景整体链路大概分为三段Unity端出包、微信开发者工具调试、公众平台提审发布。Unity端要做的是把项目构建成 WebGL 产物再用微信团队提供的转换工具转成小游戏结构微信开发者工具里导入转换结果填写 AppID跑通模拟器和真机预览最后上传代码到公众平台完善类目、素材、隐私保护等信息后提交审核。审核通过后还可以在后台发体验版让测试人员扫码真机验证再正式发布。很多人第一次跑的时候会以为 Unity 装个“微信小游戏模块”就能一键发布实际不是。微信小游戏本质上是跑在微信客户端里的容器Unity 官方没有直接输出小游戏的构建选项必须通过 WebGL 转换工具这条路。理解了这个架构后面很多配置项就不会搞混。2. 环境准备与转换工具选型这一步值得认真对待2.1 为什么走 WebGL 而不是原生方案Unity 要接入微信小游戏目前唯一稳定可行的方案是先把游戏构建成 WebGL 产物再用微信小游戏转换工具把产物包装成小游戏工程。有些开发者会问能不能用 IL2CPP 打 Android 包再往小游戏里塞不可以微信小游戏的管理器只认它自己定义的运行时环境底层是基于浏览器 WebAssembly 能力所以 Unity 官方也只支持 WebGL 导出这一条路。这个架构带来的直接后果是你的游戏在性能上不能拿手机原生游戏的指标来衡量。WebAssembly 的密集型计算能力已经很强但渲染、物理、UI 层面的开销会比原生大尤其在低端安卓机上要注意 DrawCall 和内存峰值。做个人小游戏开头就不要上重型 URP 场景尽量用 Mobile Shader、低面数模型、合并纹理图集。2.2 需要准备的软件与版本清单我没有用太新的版本组合这一套是我测了很久比较稳的组件版本建议说明Unity2021.3 LTS 或 2022.3 LTS官方和微信转换插件对这两个版本适配稳定WebGL Build Support与 Unity 同版本在 Unity Hub 里勾选安装即可微信开发者工具最新稳定版登录用管理员或项目成员扫码minigame-unity-webgl-transformGitHub 最新 release微信团队开源维护的转换插件Unity 国际版和国内版在开发小游戏上差别不大关键是有 WebGL 模块就可以。如果你电脑之前只装了 Android/iOS 模块打开 Unity Hub选中当前项目对应的 Unity 版本在右侧 Modules 里把 WebGL Build Support 勾上安装完重启编辑器就能在 Build Settings 里看到 WebGL 平台。需要提醒的是Unity 2020 及以下的版本也能跑通转换流程但部分新版转换插件的功能不支持建议直接用 LTS 版本。另外不要用 Unity 6 Preview 或者 2023 系列的非稳定版做发布踩到 Shader 编译问题浪费时间。2.3 转换插件的选型对比微信生态里目前能用的转换方案有两套一套是 Unity 官方提供的 Instant Game 工具另一套是微信团队开源的 minigame-unity-webgl-transform。我自己更推荐后者原因如下对比项Unity Instant Gameminigame-unity-webgl-transform维护方Unity微信团队GitHub 活跃更新上手难度简单中等可配置性低高支持分包、首包资源、远程资源国内网络环境友好度一般高社区案例少多论坛和群里讨论很充分微信开源工具的接入方式并不复杂下载 release 包解压后把包内的 Assets 目录里相关文件夹整个拷贝到你的 Unity 工程 Assets 目录下刷新编辑器后菜单栏会出现“微信小游戏”这一项。后续点“转换小游戏WebGL”它会先做一次 WebGL 构建再自动调用转换流程生成小游戏工程。3. Unity 端出包全过程关键参数一个都不能漏3.1 打包前必须检查的 Player Settings这是整个流程里最容易因为配置不对导致白屏或报错的地方。我每次都会在构建前把所有关键项过一遍。构建平台File - Build Settings 里切到 WebGL点 Switch Platform。这里如果平台还是 Android/iOS后续转换工具会直接提示找不到 WebGL 模块。Player Settings 里的参数Resolution and Presentation - WebGL Template选择“Minigame”模板。转换插件会注入自己定义的小游戏模板如果你用的是默认模板构建出的 index.html 结构不匹配转换工具经常报资源找不到。Publishing Settings - Compression Format改成 Disabled。这里最容易出问题如果选择 Brotli 或 Gzip微信小游戏运行时自己去解压这些资源会有兼容性和性能问题首包加载也会异常。插件后续会有自己的压缩策略不要在 Unity 这层重复做。Other Settings - Strip Engine Code建议关闭。开启后虽然能减小包体但转换插件以及第三方库里的很多反射调用、未引用代码会被裁掉运行时出现“方法找不到”的概率明显增加。个人项目包体差价不大不值得冒这个险。Other Settings - Managed Stripping Level设为 Minimal。如果你用的库比较多调成 Disabled 更稳代价是包会大一些。Other Settings - Color Space2D 休闲游戏建议保持 Gamma3D 游戏可以用 Linear。实际上 Linear 在移动端会有 Shader 兼容风险转换后颜色变淡、变亮是常见问题。Other Settings - Scripting Define Symbols建议加入 WECHAT_MINIGAME 宏。后续代码里可以用#if UNITY_WEBGL结合自定义宏来区分微信环境比如初始化 SDK、隐藏只能端游使用的按钮。还有一个很重要的点是内存相关。Unity WebGL 产物在运行时需要一块连续的 WASM 内存个人小游戏打包后默认内存可能只有 256MB 或更小如果场景资源重、加载后内存不够游戏会在启动阶段直接崩溃。转换工具窗口里一般有“开发设置”或“内存”配置项推荐先把初始内存调到 256MB最大内存调到 512MB。当然具体要看你游戏的资源量轻量合成类 256MB 都够复杂 3D 场景可能 512MB 起步。3.2 一次完整的构建与转换操作记录这是我平时操作的标准流程每一步都带实际用途。第一步把 minigame-unity-webgl-transform 插件拷贝进 Assets 目录等 Unity 编译完成。菜单栏出现“微信小游戏”节点就说明插件加载成功。要注意插件版本和 Unity 版本匹配网上有很多老教程用的是旧版插件在 2022 LTS 上会弹出各种错误。第二步打开 Build Settings切到 WebGL确保下方没有红色报错。点开 Player Settings把上一小节说的小游戏相关配置都过一遍。这里我强烈建议你固定一个“小游戏模板工程”把设置调好之后只复制场景和代码进去不要每次都在正式工程里现改。出过太多次因为换 Unity 版本把 Player Settings 重置的情况。第三步点击菜单栏“微信小游戏 - 转换小游戏WebGL”。弹出窗口里要填 AppID也就是微信公众平台小游戏账号的 AppID。初次使用时窗口下方会让你选择构建目录默认是项目的 build 目录。最后点“构建并转换”Unity 会先弹出一个正常的 WebGL 构建任务底部进度条走完后转换工具会自动运行。第四步等待转换工具输出。转换过程中会生成一个 wechatgame 目录里面是可直接导入微信开发者工具的小游戏工程。比如 game.js、game.json、unity.data还有一堆适配文件。如果构建中途报错了不要关 Unity直接看 Console 窗口的报错信息90% 的原因是 Player Settings 没改干净。整个构建时间因人而异空场景三到五分钟带完整 3D 资源的项目可能要二十分钟甚至更久尤其是你要出首包的时候。耐心等不要中途去动工程文件。3.3 微信开发者工具运行与调试打开微信开发者工具登录后选择“小游戏”项目类型导入上一步生成的 wechatgame 目录AppID 填真实的小游戏 AppID。初次导入如果没有 AppID可以用测试号但测试号有些能力受限比如广告组件调不出来建议尽早注册真实账号。工具模拟器里点击“编译”后如果项目构建正确应该能看到 Unity 的 Splash 页面或者你的引导界面。这里有人会卡很久表现为加载到 100% 后一直白屏。最常见的两个问题一是基础库版本太旧在工具右上角详情里把调试基础库切到 3.x 的最新稳定版二是压缩格式没有关闭回去把 Compression Format 改成 Disabled 再重新构建。我在微信开发者工具里调试时习惯同时打开 Performance 面板和 Console 面板。Console 里出现红色报错先找是不是自己代码的问题再查插件版本。开发者工具里跑的游戏性能不代表真机模拟器用的是 PC 浏览器内核性能偏高所以每次验证完逻辑后一定要扫码真机预览。真机预览时手机和电脑要在同一网络下同时保证手机微信可以访问开发服务器。第一次预览手机会提示“添加开发者”需要在手机上确认。跑真机时重点看内存占用、加载时间、帧率建议用微信开发者工具自带的调试性能面板而不是肉眼感受。4. 微信公众平台配置与发布看似简单其实很繁琐4.1 注册、AppID 申请与管理进入微信公众平台官网选择“小游戏”注册用未绑定过其他公众平台的邮箱邮箱接收激活确认。然后选择主体类型“个人”这一步骤需要你填写身份证信息、手机号、管理员微信扫码。整个过程大概十分钟唯一需要注意的是管理员信息后续很多操作都需要管理员的扫码确认建议直接用你长期使用的主微信号当管理员。注册成功后进入后台“设置 - 开发设置”就能看到 AppID 和 AppSecret。AppID 是公开的需要填到 Unity 转换工具和微信开发者工具里AppSecret 千万不要泄露到代码里它相当于你账号的 API 密钥。需要服务端调用开放接口时AppSecret 签名方式放在自己的服务器端。个人主体账号没有认证费用但后续如果想用更多能力比如开放数据域里的复杂个性化推荐可能还是需要在后台完成一轮验证。即便没验证的基础能力也够Unity小游戏跑起来了。4.2 域名、开放数据域与素材准备接入微信小游戏前端发请求非常受域名限制。在开发调试阶段你可以在微信开发者工具右上角“详情 - 本地设置”勾选“不校验合法域名”这样开发的时候请求自己的局域网服务没问题但一旦上传代码到测试版和正式版所有 wx.request、wx.uploadFile、wx.downloadFile 甚至 WebSocket 的地址都必须在公众平台后台“开发管理 - 服务器域名”里配置并且要求域名已完成备案且强制 https。很多个人开发者在本地联调时没问题上传后真机请求全部失败就是因为合法域名没有配置或者域名没有备案。如果你没有自己的备案域名初期可以直接用云开发能力微信小游戏自带的 wx.cloud 可以省去服务器域名配置这一层。排行榜功能也是这个环节比较关注的。Unity 转小游戏后游戏主线程不能直接访问微信好友关系链数据必须在“开放数据域”里调用 wx.getFriendCloudStorage 和 wx.setUserCloudStorage 来处理。简单说你先把玩家得分存到微信云存储然后在开放数据域里拉取好友分数并渲染排行榜最后把渲染出的图像传给主域展示。Unity 这边一般不直接参与排行榜 UI 渲染而是预留一个透明纹理区域把子域传来的 Canvas 图像贴上去。这个方案细节比较多建议第一次做排行榜时先用一个最小示例跑通登录、上传分数、拉取好友分数、显示排名。不要一上来就把排行榜嵌入游戏主场景。素材准备上后台会要求上传小游戏图标和介绍截图。图标尺寸通常 144x144截图不能带二维码、水印和联系方式。类目选择“小游戏”实际上个人主体可选类目不多但小游戏本身就是一个独立类目不用再选“教育”“工具”之类除非你是把 Unity 小游戏当互动工具做。4.3 从上传代码到提审发布在微信开发者工具里点击“上传”填上版本号和版本描述这一步会把当前代码上传到公众平台的开发版本里。然后进入公众平台后台“版本管理”找到刚上传的开发版本点击“提交审核”。提交审核时系统会弹出一系列确认项包括类目、内容、隐私保护说明。最关键的是关于“是否涉及经营虚拟支付”的确认当你选择“否”时再按照后台提示走免版号流程。这个环节不同时间的后台文案可能不一样但核心逻辑不变没有内购的游戏才有免版号的可能性。审核周期我经历过的短则几小时长则三四天。第一次提审大概率会遇到驳回常见原因是隐私保护指引不完整、截图或描述里有违规词、没有填写客服联系方式。别慌根据驳回原因逐项修改后重新提审即可。个人开发者没有客服电话可以留邮箱后台也没强制要电话。审核通过后不会立即发布你需要再次登录后台在“版本管理 - 审核通过版本”里点击“发布”。发布后还要在“用户管理”里把版本设置为“全量发布”这样用户才能搜到。如果只点了发布但没全量发布线上可能还是只有体验版。5. 上线后必须关注的性能与常见问题避开这些坑体验会好很多5.1 包体、加载、内存三座大山微信小游戏主包上限一般不能超过 4M整个小游戏总包上限不能超过 20M。Unity 游戏哪怕只是空场景导出后都可能有 10M 以上所以转换工具里提供的分包和远程资源能力不是可选项是必选项。我常用的方式是把 Unity 游戏首秀场景放到主包其他后续资源放到子包或 CDN。转换工具支持把 WebGL 的 data、wasm、框架文件拆到不同位置配合微信小游戏分包 API 可以做到先加载一个非常小的首包再在 Splash 界面后台拉取剩余资源。这个体验比硬啃一个 20M 大包好很多。内存上转换后 Unity 游戏的 WASM 内存会随着场景加载持续增长。建议在代码里少用动态创建的大数组UI 图片全部打成图集粒子系统峰值控制住AudioSource 数量不要无限制增加。问题往往不在某个单点而是累计起来把手机内存顶爆。测试时多拿几台低端安卓机跑尤其注意 3GB 以下内存的老机型。启动速度也是小游戏审核体验的一部分。审核和用户都很在意点进来多久能开始玩尽量让第一个场景保持简单避免在 Start 里做大量资源加载和网络请求。用一个 Splash 场景承载初始化主场景放到后台加载能够直观提升首屏速度。5.2 高频问题与解决办法速查表问题现象可能原因解决办法转换工具提示“No valid Unity Editor license found”Unity 许可证未激活或过期在 Unity 账号里激活 Personal License重新打开工程微信开发者工具提示“game.js:1 SyntaxError”Unity 版本与转换插件版本不匹配换成支持的 LTS 版本更新插件到最新 release加载到 100% 白屏Compression Format 配置不对改成 Disabled 后重新构建转换真机请求接口报“url not in domain list”合法域名未配置或域名未备案公众平台后台配置 https 合法域名且域名完成备案排行榜拉取不到好友数据未在开放数据域调用接口检查子域代码确认步骤是上传分数再拉取好友分数游戏闪退或内存爆掉WASM 内存峰值超限降低初始内存优化纹理、粒子、动态数组压缩资源提审被驳回“类目与内容不符”后台类目选择不当或个人主体选择了受限类目类目改成小游戏按实际内容重新描述功能上传代码时提示“版本号格式不正确”版本号不规范用纯数字加点的版本号例如 1.0.0开发者工具模拟器正常真机卡顿严重模拟器调用的是 PC 浏览器底层以真机性能面板数据为准降低渲染构成本5.3 我踩过的一些坑和最终建议账号前期是最容易被忽略的。我见过有人在已有小程序账号的邮箱下去注册小游戏结果一直提示邮箱被绑定其实同一个邮箱不能同时注册多个平台账号注册前确认邮箱没被占用。还有一点一个人只能绑定一个小游戏管理员如果你的微信已经绑定了其他小程序需要先解绑或者借用家人身份注册但这会牵扯到支付和提现建议还是用自己的主微信。代码层面建议在项目一开始就加上平台宏区分保留一个可以在编辑器里直接 Play 的环境这样不用每次测试都走一遍完整转换流程。我自己的做法是写了一个编辑器脚本可以在不打开转换 UI 的情况下自动设置 Player Settings、执行构建和转换减少重复操作带来的配置漂移。提审角度素材和描述要留好备份。每次审核驳回的记录最好截图存档特别是隐私保护指引的修改不同平台版本对文案要求有差异备份后再次提审就省去回忆成本。整体来说个人主体免版号发布微信小游戏这条路是完全可行的但它考验的是信息整合能力和耐心而不是技术单一深度。跑通第一版后后面再迭代就是常规更新了。
个人开发者Unity微信小游戏免版号上架全流程实战指南
这两年找我咨询个人开发者能不能做微信小游戏的人特别多多数人第一反应都是“要不先注册个公司”“要不找个中介买个版号”但如果你做的是纯休闲、没有虚拟支付能力的游戏个人主体完全可以自己跑完 Unity 到微信小游戏的上架全流程而且确实有免版号通道。这篇文章把我自己反复跑了多遍的完整流程、踩过的坑、以及哪些环节容易卡住一次性整理出来建议收藏后再看内容比较长但每一条都值得落地。先说结论个人主体接入微信小游戏核心优势是门槛低不需要对公账户、不需要企业认证费只要能通过微信实名验证就能注册而限制也很明显不能开通虚拟支付也就是游戏内不能有充值、购买金币这类功能同时类目选择上不占优势。所以适合个人主体做的基本就是纯广告变现的休闲游戏、工具型小游戏、互动益智类产品。理解了这一层后面所有流程其实都已经有了明确边界照着做就行。1. 整体思路先理清个人主体到底能做什么、免版号又是什么1.1 个人主体与企业的差异很多开发者一听到“微信小游戏”就以为必须有个营业执照或者是被网上那些代办公司给绕晕了。实际上微信公众平台是支持个人主体注册小游戏账号的注册入口选“小游戏”主体类型选“个人”后面就是邮箱、身份证、管理员微信扫码这些常规操作不需要对公账户验证。个人主体真正要接受的限制是支付能力。微信小游戏个人主体无法开通虚拟支付也就是说游戏里不能有“6元买钻石”“18元解锁关卡”这种内购项目。但平台保留了广告变现的路径也就是流量主能力达到一定的活跃门槛后可以接入微信广告用户看完激励视频你就有收入。这一点对大多数个人开发者来说已经够了你一个没有发行资源的小团队想做内购本来也很难搞定版号和货架。除了支付个人主体在开放接口上也有一些差异比如某些用户隐私接口、数据能力会有更严格的申请条件。但基础能力比如登录、分享、排行榜、云存储、广告组件都是有的不影响Unity游戏接入。1.2 免版号的实际含义与合规前提“免版号”这个词在圈子里容易引起误解它不是说你什么游戏都能直接发而是建立在“不涉及虚拟支付、不涉及需要前置审批的题材”这个前提下。简单说如果你的小游戏没有充值入口不搞棋牌、彩票、金融这类需要专门资质的题材而是休闲合成、答题、模拟经营、交互叙事这类内容微信公众平台的后台是可以引导你走免版号提交的。实际操作中个人主体在提交审核时后台会让你确认游戏是否涉及经营也就是有没有虚拟支付。选“否”之后正常情况不需要上传版号只要游戏内容合规、隐私保护完善审核就可以走量。这里要注意两点一是平台政策随时可能调整提审前一定要看一眼最新的《微信小游戏运营规范》和后台实际问询二是即使免版号你的游戏名称、图标、简介、截图、隐私保护指引这些基础资料也必须齐全不能抱着“反正没版号审核会松”的心态。我自己给朋友做过几次上线支持碰到最多的驳回原因是隐私保护指引没有写清楚、游戏截图带第三方水印、描述里出现“充值”“支付”这类敏感词。这些在个人主体上尤其容易踩因为很多模板都是从企业主体教程里复制过来的信息没有改干净。1.3 完整流程全景整体链路大概分为三段Unity端出包、微信开发者工具调试、公众平台提审发布。Unity端要做的是把项目构建成 WebGL 产物再用微信团队提供的转换工具转成小游戏结构微信开发者工具里导入转换结果填写 AppID跑通模拟器和真机预览最后上传代码到公众平台完善类目、素材、隐私保护等信息后提交审核。审核通过后还可以在后台发体验版让测试人员扫码真机验证再正式发布。很多人第一次跑的时候会以为 Unity 装个“微信小游戏模块”就能一键发布实际不是。微信小游戏本质上是跑在微信客户端里的容器Unity 官方没有直接输出小游戏的构建选项必须通过 WebGL 转换工具这条路。理解了这个架构后面很多配置项就不会搞混。2. 环境准备与转换工具选型这一步值得认真对待2.1 为什么走 WebGL 而不是原生方案Unity 要接入微信小游戏目前唯一稳定可行的方案是先把游戏构建成 WebGL 产物再用微信小游戏转换工具把产物包装成小游戏工程。有些开发者会问能不能用 IL2CPP 打 Android 包再往小游戏里塞不可以微信小游戏的管理器只认它自己定义的运行时环境底层是基于浏览器 WebAssembly 能力所以 Unity 官方也只支持 WebGL 导出这一条路。这个架构带来的直接后果是你的游戏在性能上不能拿手机原生游戏的指标来衡量。WebAssembly 的密集型计算能力已经很强但渲染、物理、UI 层面的开销会比原生大尤其在低端安卓机上要注意 DrawCall 和内存峰值。做个人小游戏开头就不要上重型 URP 场景尽量用 Mobile Shader、低面数模型、合并纹理图集。2.2 需要准备的软件与版本清单我没有用太新的版本组合这一套是我测了很久比较稳的组件版本建议说明Unity2021.3 LTS 或 2022.3 LTS官方和微信转换插件对这两个版本适配稳定WebGL Build Support与 Unity 同版本在 Unity Hub 里勾选安装即可微信开发者工具最新稳定版登录用管理员或项目成员扫码minigame-unity-webgl-transformGitHub 最新 release微信团队开源维护的转换插件Unity 国际版和国内版在开发小游戏上差别不大关键是有 WebGL 模块就可以。如果你电脑之前只装了 Android/iOS 模块打开 Unity Hub选中当前项目对应的 Unity 版本在右侧 Modules 里把 WebGL Build Support 勾上安装完重启编辑器就能在 Build Settings 里看到 WebGL 平台。需要提醒的是Unity 2020 及以下的版本也能跑通转换流程但部分新版转换插件的功能不支持建议直接用 LTS 版本。另外不要用 Unity 6 Preview 或者 2023 系列的非稳定版做发布踩到 Shader 编译问题浪费时间。2.3 转换插件的选型对比微信生态里目前能用的转换方案有两套一套是 Unity 官方提供的 Instant Game 工具另一套是微信团队开源的 minigame-unity-webgl-transform。我自己更推荐后者原因如下对比项Unity Instant Gameminigame-unity-webgl-transform维护方Unity微信团队GitHub 活跃更新上手难度简单中等可配置性低高支持分包、首包资源、远程资源国内网络环境友好度一般高社区案例少多论坛和群里讨论很充分微信开源工具的接入方式并不复杂下载 release 包解压后把包内的 Assets 目录里相关文件夹整个拷贝到你的 Unity 工程 Assets 目录下刷新编辑器后菜单栏会出现“微信小游戏”这一项。后续点“转换小游戏WebGL”它会先做一次 WebGL 构建再自动调用转换流程生成小游戏工程。3. Unity 端出包全过程关键参数一个都不能漏3.1 打包前必须检查的 Player Settings这是整个流程里最容易因为配置不对导致白屏或报错的地方。我每次都会在构建前把所有关键项过一遍。构建平台File - Build Settings 里切到 WebGL点 Switch Platform。这里如果平台还是 Android/iOS后续转换工具会直接提示找不到 WebGL 模块。Player Settings 里的参数Resolution and Presentation - WebGL Template选择“Minigame”模板。转换插件会注入自己定义的小游戏模板如果你用的是默认模板构建出的 index.html 结构不匹配转换工具经常报资源找不到。Publishing Settings - Compression Format改成 Disabled。这里最容易出问题如果选择 Brotli 或 Gzip微信小游戏运行时自己去解压这些资源会有兼容性和性能问题首包加载也会异常。插件后续会有自己的压缩策略不要在 Unity 这层重复做。Other Settings - Strip Engine Code建议关闭。开启后虽然能减小包体但转换插件以及第三方库里的很多反射调用、未引用代码会被裁掉运行时出现“方法找不到”的概率明显增加。个人项目包体差价不大不值得冒这个险。Other Settings - Managed Stripping Level设为 Minimal。如果你用的库比较多调成 Disabled 更稳代价是包会大一些。Other Settings - Color Space2D 休闲游戏建议保持 Gamma3D 游戏可以用 Linear。实际上 Linear 在移动端会有 Shader 兼容风险转换后颜色变淡、变亮是常见问题。Other Settings - Scripting Define Symbols建议加入 WECHAT_MINIGAME 宏。后续代码里可以用#if UNITY_WEBGL结合自定义宏来区分微信环境比如初始化 SDK、隐藏只能端游使用的按钮。还有一个很重要的点是内存相关。Unity WebGL 产物在运行时需要一块连续的 WASM 内存个人小游戏打包后默认内存可能只有 256MB 或更小如果场景资源重、加载后内存不够游戏会在启动阶段直接崩溃。转换工具窗口里一般有“开发设置”或“内存”配置项推荐先把初始内存调到 256MB最大内存调到 512MB。当然具体要看你游戏的资源量轻量合成类 256MB 都够复杂 3D 场景可能 512MB 起步。3.2 一次完整的构建与转换操作记录这是我平时操作的标准流程每一步都带实际用途。第一步把 minigame-unity-webgl-transform 插件拷贝进 Assets 目录等 Unity 编译完成。菜单栏出现“微信小游戏”节点就说明插件加载成功。要注意插件版本和 Unity 版本匹配网上有很多老教程用的是旧版插件在 2022 LTS 上会弹出各种错误。第二步打开 Build Settings切到 WebGL确保下方没有红色报错。点开 Player Settings把上一小节说的小游戏相关配置都过一遍。这里我强烈建议你固定一个“小游戏模板工程”把设置调好之后只复制场景和代码进去不要每次都在正式工程里现改。出过太多次因为换 Unity 版本把 Player Settings 重置的情况。第三步点击菜单栏“微信小游戏 - 转换小游戏WebGL”。弹出窗口里要填 AppID也就是微信公众平台小游戏账号的 AppID。初次使用时窗口下方会让你选择构建目录默认是项目的 build 目录。最后点“构建并转换”Unity 会先弹出一个正常的 WebGL 构建任务底部进度条走完后转换工具会自动运行。第四步等待转换工具输出。转换过程中会生成一个 wechatgame 目录里面是可直接导入微信开发者工具的小游戏工程。比如 game.js、game.json、unity.data还有一堆适配文件。如果构建中途报错了不要关 Unity直接看 Console 窗口的报错信息90% 的原因是 Player Settings 没改干净。整个构建时间因人而异空场景三到五分钟带完整 3D 资源的项目可能要二十分钟甚至更久尤其是你要出首包的时候。耐心等不要中途去动工程文件。3.3 微信开发者工具运行与调试打开微信开发者工具登录后选择“小游戏”项目类型导入上一步生成的 wechatgame 目录AppID 填真实的小游戏 AppID。初次导入如果没有 AppID可以用测试号但测试号有些能力受限比如广告组件调不出来建议尽早注册真实账号。工具模拟器里点击“编译”后如果项目构建正确应该能看到 Unity 的 Splash 页面或者你的引导界面。这里有人会卡很久表现为加载到 100% 后一直白屏。最常见的两个问题一是基础库版本太旧在工具右上角详情里把调试基础库切到 3.x 的最新稳定版二是压缩格式没有关闭回去把 Compression Format 改成 Disabled 再重新构建。我在微信开发者工具里调试时习惯同时打开 Performance 面板和 Console 面板。Console 里出现红色报错先找是不是自己代码的问题再查插件版本。开发者工具里跑的游戏性能不代表真机模拟器用的是 PC 浏览器内核性能偏高所以每次验证完逻辑后一定要扫码真机预览。真机预览时手机和电脑要在同一网络下同时保证手机微信可以访问开发服务器。第一次预览手机会提示“添加开发者”需要在手机上确认。跑真机时重点看内存占用、加载时间、帧率建议用微信开发者工具自带的调试性能面板而不是肉眼感受。4. 微信公众平台配置与发布看似简单其实很繁琐4.1 注册、AppID 申请与管理进入微信公众平台官网选择“小游戏”注册用未绑定过其他公众平台的邮箱邮箱接收激活确认。然后选择主体类型“个人”这一步骤需要你填写身份证信息、手机号、管理员微信扫码。整个过程大概十分钟唯一需要注意的是管理员信息后续很多操作都需要管理员的扫码确认建议直接用你长期使用的主微信号当管理员。注册成功后进入后台“设置 - 开发设置”就能看到 AppID 和 AppSecret。AppID 是公开的需要填到 Unity 转换工具和微信开发者工具里AppSecret 千万不要泄露到代码里它相当于你账号的 API 密钥。需要服务端调用开放接口时AppSecret 签名方式放在自己的服务器端。个人主体账号没有认证费用但后续如果想用更多能力比如开放数据域里的复杂个性化推荐可能还是需要在后台完成一轮验证。即便没验证的基础能力也够Unity小游戏跑起来了。4.2 域名、开放数据域与素材准备接入微信小游戏前端发请求非常受域名限制。在开发调试阶段你可以在微信开发者工具右上角“详情 - 本地设置”勾选“不校验合法域名”这样开发的时候请求自己的局域网服务没问题但一旦上传代码到测试版和正式版所有 wx.request、wx.uploadFile、wx.downloadFile 甚至 WebSocket 的地址都必须在公众平台后台“开发管理 - 服务器域名”里配置并且要求域名已完成备案且强制 https。很多个人开发者在本地联调时没问题上传后真机请求全部失败就是因为合法域名没有配置或者域名没有备案。如果你没有自己的备案域名初期可以直接用云开发能力微信小游戏自带的 wx.cloud 可以省去服务器域名配置这一层。排行榜功能也是这个环节比较关注的。Unity 转小游戏后游戏主线程不能直接访问微信好友关系链数据必须在“开放数据域”里调用 wx.getFriendCloudStorage 和 wx.setUserCloudStorage 来处理。简单说你先把玩家得分存到微信云存储然后在开放数据域里拉取好友分数并渲染排行榜最后把渲染出的图像传给主域展示。Unity 这边一般不直接参与排行榜 UI 渲染而是预留一个透明纹理区域把子域传来的 Canvas 图像贴上去。这个方案细节比较多建议第一次做排行榜时先用一个最小示例跑通登录、上传分数、拉取好友分数、显示排名。不要一上来就把排行榜嵌入游戏主场景。素材准备上后台会要求上传小游戏图标和介绍截图。图标尺寸通常 144x144截图不能带二维码、水印和联系方式。类目选择“小游戏”实际上个人主体可选类目不多但小游戏本身就是一个独立类目不用再选“教育”“工具”之类除非你是把 Unity 小游戏当互动工具做。4.3 从上传代码到提审发布在微信开发者工具里点击“上传”填上版本号和版本描述这一步会把当前代码上传到公众平台的开发版本里。然后进入公众平台后台“版本管理”找到刚上传的开发版本点击“提交审核”。提交审核时系统会弹出一系列确认项包括类目、内容、隐私保护说明。最关键的是关于“是否涉及经营虚拟支付”的确认当你选择“否”时再按照后台提示走免版号流程。这个环节不同时间的后台文案可能不一样但核心逻辑不变没有内购的游戏才有免版号的可能性。审核周期我经历过的短则几小时长则三四天。第一次提审大概率会遇到驳回常见原因是隐私保护指引不完整、截图或描述里有违规词、没有填写客服联系方式。别慌根据驳回原因逐项修改后重新提审即可。个人开发者没有客服电话可以留邮箱后台也没强制要电话。审核通过后不会立即发布你需要再次登录后台在“版本管理 - 审核通过版本”里点击“发布”。发布后还要在“用户管理”里把版本设置为“全量发布”这样用户才能搜到。如果只点了发布但没全量发布线上可能还是只有体验版。5. 上线后必须关注的性能与常见问题避开这些坑体验会好很多5.1 包体、加载、内存三座大山微信小游戏主包上限一般不能超过 4M整个小游戏总包上限不能超过 20M。Unity 游戏哪怕只是空场景导出后都可能有 10M 以上所以转换工具里提供的分包和远程资源能力不是可选项是必选项。我常用的方式是把 Unity 游戏首秀场景放到主包其他后续资源放到子包或 CDN。转换工具支持把 WebGL 的 data、wasm、框架文件拆到不同位置配合微信小游戏分包 API 可以做到先加载一个非常小的首包再在 Splash 界面后台拉取剩余资源。这个体验比硬啃一个 20M 大包好很多。内存上转换后 Unity 游戏的 WASM 内存会随着场景加载持续增长。建议在代码里少用动态创建的大数组UI 图片全部打成图集粒子系统峰值控制住AudioSource 数量不要无限制增加。问题往往不在某个单点而是累计起来把手机内存顶爆。测试时多拿几台低端安卓机跑尤其注意 3GB 以下内存的老机型。启动速度也是小游戏审核体验的一部分。审核和用户都很在意点进来多久能开始玩尽量让第一个场景保持简单避免在 Start 里做大量资源加载和网络请求。用一个 Splash 场景承载初始化主场景放到后台加载能够直观提升首屏速度。5.2 高频问题与解决办法速查表问题现象可能原因解决办法转换工具提示“No valid Unity Editor license found”Unity 许可证未激活或过期在 Unity 账号里激活 Personal License重新打开工程微信开发者工具提示“game.js:1 SyntaxError”Unity 版本与转换插件版本不匹配换成支持的 LTS 版本更新插件到最新 release加载到 100% 白屏Compression Format 配置不对改成 Disabled 后重新构建转换真机请求接口报“url not in domain list”合法域名未配置或域名未备案公众平台后台配置 https 合法域名且域名完成备案排行榜拉取不到好友数据未在开放数据域调用接口检查子域代码确认步骤是上传分数再拉取好友分数游戏闪退或内存爆掉WASM 内存峰值超限降低初始内存优化纹理、粒子、动态数组压缩资源提审被驳回“类目与内容不符”后台类目选择不当或个人主体选择了受限类目类目改成小游戏按实际内容重新描述功能上传代码时提示“版本号格式不正确”版本号不规范用纯数字加点的版本号例如 1.0.0开发者工具模拟器正常真机卡顿严重模拟器调用的是 PC 浏览器底层以真机性能面板数据为准降低渲染构成本5.3 我踩过的一些坑和最终建议账号前期是最容易被忽略的。我见过有人在已有小程序账号的邮箱下去注册小游戏结果一直提示邮箱被绑定其实同一个邮箱不能同时注册多个平台账号注册前确认邮箱没被占用。还有一点一个人只能绑定一个小游戏管理员如果你的微信已经绑定了其他小程序需要先解绑或者借用家人身份注册但这会牵扯到支付和提现建议还是用自己的主微信。代码层面建议在项目一开始就加上平台宏区分保留一个可以在编辑器里直接 Play 的环境这样不用每次测试都走一遍完整转换流程。我自己的做法是写了一个编辑器脚本可以在不打开转换 UI 的情况下自动设置 Player Settings、执行构建和转换减少重复操作带来的配置漂移。提审角度素材和描述要留好备份。每次审核驳回的记录最好截图存档特别是隐私保护指引的修改不同平台版本对文案要求有差异备份后再次提审就省去回忆成本。整体来说个人主体免版号发布微信小游戏这条路是完全可行的但它考验的是信息整合能力和耐心而不是技术单一深度。跑通第一版后后面再迭代就是常规更新了。 
