# Cocos Creator 在当前 NAS Linux 环境中的可行性结论

> 检查日期：2026-10-07
> 检查对象：Cocos Creator（本项目暂定技术方向）+ TypeScript + 微信小游戏首发
> 检查机器：fnOS 1.2.0604（Debian 12 bookworm）/ x86_64 / 16 核 / 15Gi 内存
> 检查方式：查阅**官方**文档与官方发布说明；**未下载任何安装包**，**未安装任何第三方修改版**

---

## 一、最终结论

> **NAS 可作为项目文件、脚本和构建辅助环境，但 Cocos Creator 编辑器需要其他系统运行。**

- Cocos Creator 编辑器：**官方无 Linux 版本** → 无法在 NAS 上运行。
- 微信开发者工具：**官方无 Linux 版本** → 同样无法在 NAS 上运行。
- 因此本项目当前的实际形态只能是：**编辑器在 Windows/macOS，项目文件在 NAS**。

---

## 二、六个问题的逐条回答

### 1. 是否有官方 Linux 版本？

**没有。**

官方依据：

- Cocos 官方文档《安装和启动》（Creator 3.8 手册）原文：
  > 「Cocos Dashboard 所支持的系统环境是：Mac OS X 所支持的最低版本是 OS X 10.9。Windows 所支持的最低版本是 Windows 7 64位。」
- 同页安装说明只给出两种安装包：Windows 的 `.exe`（`CocosDashboard-vX.X.X-win32-20XXXXXX.exe`）与 macOS 的 `.dmg`。
- 官方下载页 `https://www.cocos.com/creator-download` 只提供 Windows / macOS 安装包，**没有 Linux 条目**。

补充事实：

- Cocos 官方论坛存在题为 *Poll: Why do you want a Linux version of Cocos Creator?* 的投票帖，说明 Linux 版是**社区诉求**而非**已发布产品**。
- 社区存在**非官方 Linux 移植版**（历史上有针对 1.9.x 的第三方移植）。按你的明确要求：**不使用、不下载、不安装**。
- 需要区分一个容易混淆的点：Cocos 更新日志里的「支持在本地桌面平台（Windows、Linux、macOS）上向执行文件传递命令行参数」指的是**引擎运行时/原生目标平台**支持 Linux，**不是编辑器支持 Linux**。

### 2. 当前 CPU 架构是否支持？

**架构层面没问题，但不构成可行路径。**

- 本机架构：`x86_64`。
- Cocos 官方支持的平台正是 x86_64：Windows 64 位、macOS（Intel / Apple Silicon）。
- 但**因为没有 Linux 编辑器**，在 NAS 上讨论「架构是否支持」没有实际意义——**没有可执行的编辑器二进制**。

### 3. 是否需要图形界面？

**需要，而且是硬性要求。**

- Cocos Creator 编辑器本身是图形化程序（场景编辑、属性检查器、资源管理器等）。
- 官方文档在「检查显卡驱动」一节明确写道：
  > 「编辑器依赖 GPU 渲染，而显卡驱动不支持导致的。如果出现这种情况，通常只要确保已成功安装显卡对应型号的官方驱动即可解决。」
- 即：**需要真实可用的图形界面 + GPU 渲染能力**，不能只靠无头模式替代日常开发。

### 4. 是否可以通过远程桌面运行？

**在当前 NAS 上不行。**

已核查的本机现状：

| 项目 | 状态 |
| --- | --- |
| `DISPLAY` / `WAYLAND_DISPLAY` | 未设置 |
| 显示管理器（gdm3 / lightdm / sddm / xdm） | 全部未安装 |
| 桌面环境（GNOME / XFCE / KDE / LXDE / MATE） | 未安装 |
| `/usr/share/xsessions/` | 仅 `openbox.desktop` 一个会话描述文件 |
| xrdp | 未安装 |
| VNC Server（`vncserver` / `x11vnc`） | 未安装 |
| Xvfb | 已安装（`2:21.1.7-3+deb12u13`），但只能提供**无头虚拟显示**，不是可交互桌面 |
| GPU | Intel UHD 730，`/dev/dri/card0`、`renderD128` 存在 |
| `systemctl get-default` | `graphical.target`（active，但无显示管理器接管） |

结论有两层：

1. **没有 Linux 版编辑器可运行**，所以远程桌面这条路当前无对象可连。
2. 即使将来有，本机也**没有安装任何远程桌面服务**，需要另行搭建（X + 桌面环境 + xrdp/VNC），且**通过远程桌面操作 GPU 编辑器体验通常较差**（延迟、渲染、输入）。

> 本轮**未安装任何远程桌面组件**。

### 5. 是否可以在当前环境完成项目创建和预览？

**不能。**

- **项目创建**：由 Cocos Dashboard / 编辑器完成，Dashboard 无 Linux 版。
- **浏览器预览**：预览服务器由**编辑器进程**拉起（编辑器内点「预览」后启动本地服务），无编辑器则无预览。
- **命令行构建也不行**：官方文档《命令行发布项目》给出的调用方式是**直接调用编辑器可执行文件**：
  - Mac：`/Applications/CocosCreator/Creator/3.0.0/CocosCreator.app/Contents/MacOS/CocosCreator --project projectPath --build "..."`
  - Windows：`...\CocosCreator.exe --project projectPath --build "..."`
  - 官方文档**只提供 Mac 与 Windows 两种路径**，没有 Linux 路径。

所以：**项目创建、预览、命令行构建三者都依赖编辑器，NAS 上都无法完成。**

### 6. 是否需要在 Windows/macOS 上运行编辑器，再把项目文件放到 NAS？

**是，这是当前唯一可行方案。**

推荐分工：

| 角色 | 承担机器 | 职责 |
| --- | --- | --- |
| 编辑器 | Windows 或 macOS | Cocos Creator（建工程、场景、预览、构建微信小游戏包） |
| 微信工具 | 同一台 Windows/macOS | 微信开发者工具（调试、真机预览、上传提审） |
| 文件与版本 | NAS `/vol1/ai/projects/wyszz-new` | 项目文件、脚本、资源、文档、Git 仓库、构建产物归档 |

---

## 三、微信小游戏工具链的同等结论（关键补充）

首发平台是微信小游戏，因此这条必须一并说清：

**微信开发者工具同样只有 Windows 与 macOS 版本。**

官方依据：

- 微信官方文档《微信开发者工具下载地址与更新日志》当前稳定版（2.01.2510260）提供：
  `Windows 64`、`Windows 32`、`macOS x64`、`macOS ARM64`
- 同页注明：「Windows 仅支持 Windows 7 及以上版本」。
- 微信开放社区存在置顶反馈帖《关于微信开发者工具 Linux 版本缺失的反馈及适配计划咨询》，开发者明确请求 Linux 版；**官方未提供 Linux 版本**。

补充事实：微信开发者工具基于 NW.js 打包（Nightly 版基于 NW.js 0.54.1 / 0.81.1，后者内置 node 20.7.0），**自带运行时，不依赖系统 Node.js**。

**因此：微信小游戏的调试、预览、上传提审也必须在 Windows/macOS 上完成，NAS 无法替代。**

---

## 四、后续可选方案（仅列出，本轮未执行任何一项）

| 方案 | 内容 | 优点 | 代价 / 风险 |
| --- | --- | --- | --- |
| **A. 双机分工（推荐）** | Windows/macOS 装 Cocos Creator + 微信开发者工具；NAS 通过 SMB/网络盘承载项目目录 | 与已定技术方向完全一致；NAS 发挥文件与备份优势 | 需一台 Windows/macOS；编辑器跨网络盘读写大工程可能变慢 |
| **B. 编辑器本地 + NAS 当远端仓库** | 本地开发，Git push 到 NAS 裸仓库做备份/协作 | 编辑器性能最好，版本管理清晰 | 需要维护同步流程，NAS 不参与实时编辑 |
| **C. 改用 Godot 路线** | Godot 官方**提供 Linux 版编辑器**，是当前 NAS 上唯一能原生跑编辑器的候选（旧项目 `little-town` 正是 Godot 4.7） | NAS 可独立完成编辑与预览 | **与已定 Cocos + 微信小游戏首发方向不一致**；Godot 导出微信小游戏生态与 Cocos 不同，需重新评估 |
| **D. 等待官方 Linux 版** | 关注 Cocos 官方是否发布 Linux 编辑器 | 无需额外机器 | 目前**无官方发布计划**，时间不可控 |

> ⚠️ 以上方案**均未自动执行**。引擎选型是你的决策：
> - 我**不会**擅自把 Godot 作为新项目引擎；
> - 我**不会**擅自改成 Unity 或纯网页项目；
> - 我**不会**安装任何第三方修改版 Cocos Creator。

---

## 五、给后续阶段的提醒

1. **在拿到 Windows/macOS 编辑器机器之前，NAS 侧能做的只有**：目录结构、文档、脚本、资源整理、Git 仓库、构建产物归档。
2. **不要把「NAS 能存项目」误当成「NAS 能开发项目」**——建工程、预览、构建、提审四步都不在 NAS 上。
3. 若将来要在 NAS 上做**自动化构建**：Cocos 官方命令行构建依赖编辑器二进制，**Linux 上不可行**；需在 Windows/macOS 构建机上执行，或评估官方是否推出 CI/Linux 方案。
4. Node.js 版本问题与编辑器无关（编辑器自带运行时）；仅引擎级编译工具链有 Node 18.x 适配要求，详见 `环境检查报告-2026-10-07.md` 第 4.3 节。
