BLOG / 博客文章

技术文章

Cocos Creator 技术原理、架构设计与踩坑记录

mise · 开发环境 · 版本管理 · Node.js · Python · Java

我把 nvm、pyenv、jenv 全换成了 mise

Node.js、Python、Java 分别交给 nvm、pyenv、jenv 管理,带来的不只是三套命令,还有混乱的 shell 初始化和难以复现的项目环境。我把它们统一迁移到 mise,用一份 mise.toml 锁定团队工具版本,并分享项目切换、临时执行、IDE 集成、安全信任和旧版本兼容中的真实体验与边界。

阅读文章 →
多语言适配 · i18n · 游戏开发 · Cocos Creator · 国际化

被老板一句话逼出来的(纯野路子)硬编码文本多语言方案:怎么在基本不影响日常开发的前提下,把翻译的路提前铺好

运营两年的游戏突然被一句'发海外',硬编码中文全部返工。于是我琢磨出一套野路子:两层key——短词走常量表、一次性长句用中文原文当key;简中零成本;禁止拼接统一占位符;AST扫描工具兜底。不影响日常开发,提前铺好翻译的路,不出海代价近乎为零。

阅读文章 →
代码整洁之道 · 读书笔记 · 代码质量 · 编程实践

值得每个程序员认真读不止一遍的《代码整洁之道》究竟说了些什么?

《代码整洁之道》我读过5遍以上。这篇文章记录最让我对照自己代码脸红的几个判断:童子军军规、可搜索的命名、只做一件事的函数、解释「为什么」的注释、对象与数据结构的边界、不返回null,以及简单设计四规则的优先级顺序。它不教新概念,而是把常识用可执行的标准串起来。

阅读文章 →
Claude Code · AI编程 · 配置指南 · Auto Memory · Cocos Creator

Claude Code 配置指南:三层记忆 + 四层执行

Claude Code 每次会话都是全新上下文,没有配置就没有记忆。本文把官方文档翻了几遍后总结出完整配置体系:记忆层三层(CLAUDE.md、Rules、Auto Memory),执行层四层(Skills、MCP、Hooks、Agents),一篇看全。

阅读文章 →
Claude Code · AI编程 · 自定义命令 · Slash Commands · Cocos Creator · 效率工具

Cocos 游戏项目的 Claude Code 配置实践(8):自定义命令

Skills 之外,Claude Code 还有更轻量的 .claude/commands/ 机制:一个 Markdown 文件就是一个斜杠命令。分享 Commands 和 Skills 的关系、参数传递、动态 Shell 注入特性,以及我在用的几个命令和踩坑经验。

阅读文章 →
Claude Code · AI编程 · Agents · 代码审查 · Cocos Creator · ECS

Cocos 游戏项目的 Claude Code 配置实践(7):Agents

系列最后一层:Agents。代码 review 需要理解项目架构的专业判断,通用 AI 做不了。分享我的 game-reviewer Agent 设计:系统提示、审查流程、分级输出,以及探索型 Agent 保护主对话上下文的用法。

阅读文章 →
Claude Code · AI编程 · Hooks · 代码质量 · Cocos Creator · 自动化

Cocos 游戏项目的 Claude Code 配置实践(6):Hooks

Rules 靠 AI 自觉遵守,但 AI 有时会「忘记」规范。Hooks 在系统层面强制执行:AI 写完文件立刻跑 eslint 和 tsc 类型检查,有问题自动反馈修复。分享我的三个核心 Hook 脚本和编写技巧。

阅读文章 →
Claude Code · AI编程 · MCP · 向量数据库 · Cocos Creator · 私有框架

Cocos 游戏项目的 Claude Code 配置实践(5):MCP

AI 不认识你的私有框架 API,只能凭印象猜?我把框架的 .d.ts 文件向量化,构建本地可搜索的知识库,通过 MCP 协议暴露查询工具,让 AI 不再猜 API。附踩坑经验和值不值得做的判断标准。

阅读文章 →
Claude Code · AI编程 · Skills · Cocos Creator · FairyGUI · 自动化

Cocos 游戏项目的 Claude Code 配置实践(4):Skills

CLAUDE.md 和 Rules 是知识,Skills 是流程。分享游戏项目里的四个 Skills:从 FGUI XML 生成窗口代码、ECS 组件/系统脚手架、项目全貌扫描,以及如何判断该不该封装成 Skill 和踩坑经验。

阅读文章 →
Claude Code · AI编程 · Rules · Cocos Creator · 代码规范

Cocos 游戏项目的 Claude Code 配置实践(3):Rules

项目规范越写越多,CLAUDE.md 装不下了?Rules 通过 paths frontmatter 按文件路径动态注入规范:写 ECS 代码时自动加载 ECS 规范,零干扰。分享我的 9 份 Rules 拆分策略、与 CLAUDE.md 的分工和踩坑经验。

阅读文章 →
Claude Code · AI编程 · CLAUDE.md · Cocos Creator · 项目配置

Cocos 游戏项目的 Claude Code 配置实践(2):CLAUDE.md

CLAUDE.md 相当于给 AI 写的项目「入职手册」,写一次永久生效。分享游戏项目里最关键的四类内容:引擎版本约束、框架模块映射表、工作流约束和代码规范、项目关键路径,以及常见误区。

阅读文章 →
Claude Code · AI编程 · Cocos Creator · 游戏开发 · 配置实践

Cocos 游戏项目的 Claude Code 配置实践(1):总览

游戏项目和前端开发不是一个物种,网络上的通用 Claude Code 配置在游戏开发里很难用得上。本文分享我在 Cocos 项目里摸索出的六层配置体系:CLAUDE.md、Rules、Skills、MCP、Hooks、Agents,以及落地递进思路。

阅读文章 →
ECS · 游戏架构 · Cocos Creator · kunpo-ecs · 实体组件系统

ECS架构在游戏开发中的应用

深入探讨 ECS(实体组件系统)架构在游戏开发中的应用。从架构优劣分析到适用场景,结合《宫爆老奶奶》《比特小队》项目实践和 kunpo-ecs 开源框架,分享 ECS 架构如何解决传统面向对象设计的继承复杂性、提升游戏开发的扩展性和可维护性。

阅读文章 →
cocos-creator · 自动化打包 · 工程化 · Pipeline · CI/CD

自动化打包工具架构设计

分享一个 Cocos Creator 多渠道自动化打包工具的设计思路,采用 Pipeline 模式实现灵活的构建流程,支持 Android、iOS、鸿蒙、微信小游戏等10+平台一键打包。

阅读文章 →
cocos-creator · 热更新 · 原生平台 · 问题排查

热更新最佳实践【CocosCreator】

从 project.manifest、version.manifest 的工作原理讲起,结合真实项目踩过的坑,梳理 Cocos Creator 热更新的完整实践:资源比对、差异下载、原生平台常见问题排查与解决思路。

阅读文章 →
Cocos Creator · 资源加载 · 游戏开发

资源加载【CocosCreator】

Cocos Creator 官方资源加载 API 用起来繁琐:批量加载要手写循环和进度统计,资源释放全靠手动记录路径。分享如何封装一套更好用的资源加载方案,解决批量加载、进度追踪与自动释放的痛点。

阅读文章 →