最近，我將之前用 Cocos Creator 2.x 寫的一個微信小游戲《球球要回家》移植到了 Cocos Creator 3.6.2 上。
編程語言也從 JavaScript 遷移到了 TypeScript，并成功上線微信小游戲。
不過在升級過程中，也踩到不少坑。
一是如何將 JS 代碼高效地翻譯成 TS 代碼。
另外是，我在使用 Creator 3.6.2 自帶的 2.x 項目升級工具存在 BUG，差點讓我放棄升級。
不過還好，遇到的問題通過 Cocos 論壇、文檔都能解決，在此做個記錄，希望對你也有所幫助。
1. 升級項目到 2.4.x 引擎版本
因為 Creator 3.x 已經不在支持 JavaScript 語言，而且 2.4.x 最新版本的 API 接口與 3.x相近。
所以，我的策略是首將代碼移植到 2.4.x TypeScript 上。
這一步，主要是解決一些廢棄 API 的問題。
在 2.4.10 上，廢棄 API 它不會報錯，但會以警告的方式提示你。
據了解 95% 的 2.4.x 以下的項目，升 2.4.5+ 是可以平滑升級的。
2. JS轉TS腳本
這一步是個體力活，一是對將 JS 腳本翻譯為 TS 腳本，二是將新的 TS 腳本重新掛載節點。
我的做法是，比如：看到有個腳本為：GameScene.js，先在它旁邊生成一個 GameSceneTS.ts 照著 JS 代碼邏輯，按 TS 語法重寫一遍代碼。
雖然這是個體力活，但是在 VSCode 中寫 TS 代碼還是很享受的，智能提示非常的方便。
3. 升級項目引擎到 3.6.x
重點來了，這一步需要使用 Creator 3.x 提供的升級工具來升級項目。
使用升級工具，我們可以不必重新去編輯游戲場景和預制體，重新去掛載腳本，能省去不少時間。
新建一個 Creator 3.x 工程，從編輯器主菜單上 文件→導入 Cocos Creator 2.x 項目，看下圖：
瀏覽需要升級的 2.x 工程目錄，會彈出下面這樣一個面板：
注意：這里有一個坑點！我最初在導入球球要回家 2.4.10 工程后發現，場景中的 Button 按鈕點不動。
為了排除是因為腳本引起的問題，我使用 2.4.10 重新建了一個 Hello World 工程，添加上 Button 按鈕，再導入 3.6.2 依然有這個問題，
試了多次無解，我再停下來看導入面板上的說明，打開一個 Github 倉庫，是這個 2.x 導入工具的插件最新版本。
看 README 中的更新說明，正好解決了按鈕不能點擊的問題，以及其他 BUG 的修復。
果斷下載插件安裝上，再次嘗試使用 Hellow World 工程導入 3.x 引擎 Button 點擊問題解決！
4. 升級 3.x 腳本代碼
UI 完美再現......OK
組件腳本節點綁定在......OK
組件屬性、節點引用、組件方法調用一切 OK！
但是，這時點擊游戲中的按鈕是沒有反應的，看代碼如下：
從上圖可以看到，升級工具將所有代碼函數體全部注釋起來了，現在要做的就是將所有函數體一個個地放開。
在 2.x 時使用的 cc.xxx 這種寫法不能再用了，必須在腳本頂部做導入模塊導入：
//從 cc 模塊中解構出 Node、Sprite 變量
import { Node, Sprite } from 'cc'
在使用 VSCode 編寫代碼時，并不需要我們手動一個個敲 import 引入的模塊，編輯器會自動添加，看下面：
小結
從 Creator 2.x 移植 3.x 的整體過程，主要為下面四步：
- 升級項目到 2.4.10 或最新版；
- 移植腳本到 TypeScript；
- 在 Creator 3.x 中使用 2.x 項目導入工具（注意使用github上的最新版本）；
- 修改 3.x 項目中不兼容 2.x 的相關接口代碼。
后續我還會有更多 Creator 2.x 升級 3.x 的經驗分享，如果本文對你有用，感謝點贊留言！
更多精彩請關注Creator星球游戲開發社區
