近年來，隨著開源軟件的普及和開源社區(qū)的發(fā)展，越來越多的開發(fā)者開始將自己的項目開源。與此同時，為了更好地管理項目代碼并擴大項目的影響力，眾多開發(fā)者也開始使用代碼托管平臺，其中以github為代表的平臺已經(jīng)深入人心。
然而，在某些場景下，我們可能需要將代碼托管到國內(nèi)的代碼托管平臺上，例如gitee。當我們決定將代碼托管到gitee上時，首先需要考慮的就是如何將代碼倉庫從GitHub遷移到gitee。
一般來說，代碼遷移有兩種方式：一種是直接將GitHub的代碼導(dǎo)出，然后在gitee上新建倉庫并導(dǎo)入代碼；另一種則是使用開源工具將GitHub的倉庫直接轉(zhuǎn)移到gitee上。下面分別介紹這兩種方式的具體操作步驟。
方式一：從GitHub導(dǎo)出代碼，上傳至gitee
第一步，打開GitHub倉庫頁面，點擊倉庫上方的“Clone or download”按鈕，選擇“Download ZIP”選項將代碼下載到本地。
第二步，打開gitee官網(wǎng)，在個人中心頁面選擇“新建倉庫”，填寫倉庫名稱、說明、代碼協(xié)議等信息，然后點擊“提交”。
第三步，在新建倉庫頁面中，點擊“上傳代碼”按鈕，選擇剛才下載的代碼ZIP文件并點擊“上傳”，等待上傳完成。
方式二：使用開源工具完成GitHub倉庫轉(zhuǎn)移
另一種轉(zhuǎn)移GitHub倉庫的方式則是使用 gitlab-mirrors 工具。這個工具是專為將GitHub倉庫遷移到其他代碼托管平臺而開發(fā)的，可以方便地將GitHub上的代碼轉(zhuǎn)移到gitee。
具體操作步驟如下：
第一步，在GitHub上點擊倉庫頁面右上角的“Settings”按鈕，打開“Options”頁面，滑動到下方找到“Danger Zone”區(qū)域，點擊“Export repository”按鈕，將代碼打包下載到本地。
第二步，打開 gitlab-mirrors GitHub首頁，將項目下載到本地，然后執(zhí)行 “bundle install” 命令安裝必需的庫文件。
第三步，所需的配置文件 .env 文件需要在項目根目錄中新建一個，然后設(shè)置 gitee 令牌：
GITLAB_API_ENDPOINT=https://gitee.com/api/v5/
GITLAB_API_PRIVATE_TOKEN=YOUR_GITEE_TOKEN
（注意：這里的 YOUR_GITEE_TOKEN 需要替換為你自己的gitee個人API私有令牌）
第四步，在終端中執(zhí)行以下命令：
bundle exec ruby gitee.rb USERNAME SOURCE_REPO_URL TARGET_NAMESPACE TARGET_REPO_NAME
其中：
- USERNAME：gitee賬號名
- SOURCE_REPO_URL：GitHub倉庫的HTTPS URL
- TARGET_NAMESPACE：gitee賬號名
- TARGET_REPO_NAME：gitee倉庫名
等待執(zhí)行完成后，就可以在 gitee 中找到轉(zhuǎn)移后的倉庫了。
總結(jié)
在本文中，我們介紹了兩種將GitHub倉庫轉(zhuǎn)移到gitee的方法，即從GitHub導(dǎo)出代碼并上傳至gitee，以及使用 gitlab-mirrors 工具完成遷移。無論我們選擇哪種方式，都需要注意保留好代碼的所有權(quán)與許可證，并遵守開源軟件的相關(guān)規(guī)定。通過將開源項目托管在gitee上，我們可以更加方便地管理和分享自己的項目，也可以加入更廣泛的開源社區(qū)，為開源事業(yè)做出自己的貢獻。
