# 2026-10-14 · 开发者工具空白小游戏项目模板 vs 我们的包：配置逐项对照

工具：微信开发者工具 **Stable 2.02.2608080**，小游戏模式。
对照组：工具「创建小游戏」生成的空白项目 `blank-test`（模板 `quickstart`）。
对象：我们构建的包 A（`dist/wechat`）被导入后的 `project.config.json`。

## ★ 结论一：`compileType` 权威定案 = `"game"`

空白项目模板**自带**的 `project.config.json`：

```json
"compileType": "game",
"libVersion": "latest",
"appid": "wxfb15f354e9bf10c5",
"projectname": "quickstart",
"isGameTourist": false
```

- 官方[小游戏配置](https://developers.weixin.qq.com/minigame/dev/reference/configuration/app.html)文档并未列 `compileType`；
  另有资料称小游戏合法值仅 `minigame`/`gamePlugin`。
- **实测：工具自己的小游戏模板写的就是 `"game"`** ⇒ 我们的包 A 写 `"game"` 与工具模板一致，**正确**。
- 反向验证（Lead 先前操作）：在工具运行中把该字段改成 `"minigame"` → 工具报
  `something wrong in electron appservice`（appservice 崩溃）⇒ 该字段**不应改**。

## 结论二：空白项目是「对照组」，证明工具侧无问题

- 空白项目创建成功，**模拟器正常运行**，Console **0 错 0 警**。
- 模板 demo 自身使用 `requestAnimationFrame` 且跑通
  ⇒ **`requestAnimationFrame` 在本工具的 appservice 里是存在的**。
- ⇒ 我们的包报 `requestAnimationFrame is not a function` **不是「环境缺 API」**，而是**我们项目侧**的问题。
  （Lead 先前「环境问题」的判断据此推翻。）

## 结论三：A 包的 `appid` 未被改写

用户提供的 A-clean 目录内 `project.config.json`（498 B）逐项与 `tools/build-wechat.mjs` 生成的一致：
`appid` 仍为 `"touristappid"`，`libVersion` 仍为 `"3.0.0"`，`compileType` 仍为 `"game"`。
⇒ **「AppID 类型/被改写」假设不成立。**

## 配置逐项对照

| 字段 | 我们的包 A | 空白模板 | 备注 |
|---|---|---|---|
| `compileType` | `"game"` | `"game"` | **一致（权威）** |
| `appid` | `"touristappid"` | `"wxfb15f354e9bf10c5"` | 游客模式 vs 小游戏测试号 |
| `projectname` | `"wyszz-island-0.1"` | `"quickstart"` | — |
| `libVersion` | `"3.0.0"` | `"latest"` | 工具实际按 3.17.4 跑 ⇒ 个人设置另有存放处 |
| `es6` | `false` | `true` | **差异** |
| `minified` | `false` | `true` | **差异** |
| `postcss` | `false` | `true` | **差异** |
| `enhance` | `false` | `false` | 一致 |
| `urlCheck` | `false` | `false` | 一致 |
| `isGameTourist` | **缺失** | `false` | **A 包缺该字段** |
| `disableUseStrict` | **缺失** | `false` | **A 包缺该字段** |
| `miniprogramRoot` | `""` | **缺失** | **A 包多出小程序专有字段** |
| `newFeature` / `uploadWithSourceMap` / `minifyWXSS` / `useCompilerPlugins` / `packNpm*` / `localPlugins` / `compileWorklet` / `minifyWXML` | **缺失** | 均有 | A 包缺 |
| `packOptions` / `editorSetting` / `simulatorPluginLibVersion` | **缺失** | 均有 | A 包缺 |
| `condition` | `{}` | 完整（search/conversation/game/miniprogram） | A 包过于简略 |

## 结论四：仍需取证的下一步

1. **`project.private.config.json`**（A 包目录与空白项目目录各一份）——
   `libVersion` 实际为 3.17.4 而 `project.config.json` 写 3.0.0，说明个人设置（含「调试基础库」）
   存放在该文件；这很可能是两环境差异的关键。
2. 空白项目的 `game.json`（对照字段）。
3. **决定性实验**：把 `dist/wechat/game.js` 覆盖进**已知良好的空白项目**（先备份原 `game.js`），
   保持空白项目自己的 `project.config.json` / `game.json` 不变，编译。
   - **能跑** ⇒ 我们的 `game.js` 没问题，问题在我们的 `project.config.json` / `game.json`
   - **仍报同一错** ⇒ 问题在我们的 `game.js`

## 仍未解释的矛盾

同一个包 A（`project.config.json` 逐字节未变）**早先在同一台机器的模拟器里能跑通，现在跑不通**。
已排除：① 基础库版本（3.0.2 与 3.17.4 均失败）；② appid 被改写（仍为 touristappid）。
