官方出品丨Cocos Creator 3.x 升级指南，常见问题一文全解

Cocos Creator 3.x 作为 Creator 的主力版本，经过引擎组的不断努力，目前已经逐渐趋于成熟与稳定，可以为开发者提供更好的服务。现为开发者提供升级 Cocos Creator 2.x 到 3.x 的详细方式，含项目升级、代码升级、材质升级、常见问题及解决。

注意： 目前我们不建议开发中的项目，特别是即将上线的项目强升 v3.x。

项目升级

目前针对 v2.4.3 以下的版本，我们推荐先将旧项目升级到 v2.4.3 或以上版本，然后再导入到 v3.x，否则无法确保导入结果的正确性。

因此升级的第一步是先将旧项目升级到 v2.4.3 或以上版本，再对旧项目进行排查，检查是否有出现问题。关于更多 v2.4.x 的升级问题可以查看 [v2.4 升级指南]。

在成功升级为 v2.4.3 或以上版本后，接下来可以在 Cocos Dashboard 中新建一个空项目并打开。如下图：

update-dashboard

然后便可以在新建的空项目中通过 Creator 的导入插件对项目进行升级。

开发者只需要点击主菜单中的 文件 -> 导入 Cocos Creator 2.x 项目。

import-menu

然后在弹出的文件浏览对话框中选择 v2.x 项目的根目录。

import-menu

v2.x 项目中所有的资源便会自动呈现在弹出的 导入 Cocos Creator 2.x 项目 面板中，开发者可以再次确认要导入的资源，然后点击面板右下角的 导入 按钮完成导入。若开发者想要切换导入的 v2.x 项目，点击下图中的搜索图标按钮，即可重新选择项目。

import-project

面板左下角的 使用说明 按钮可跳转到导入项目插件的 GitHub 仓库，用于 [更新导入插件] 或者提交反馈。

选择导入之后，项目就已经被生成到之前新建的空项目中，并且 不会改动 到原有的旧项目。项目的 资源部分 就已经成功导入啦。

代码升级

对于项目的代码，Creator 的导入插件提供了很好的代码迁移辅助。如果开发者的旧项目是使用 JavaScript 进行开发的，那么导入插件会先将 JavaScript 转换成 TypeScript，再统一进行代码的辅助迁移。

例如下面的一段代码：

<