1、簡(jiǎn)介

眾所周知，GitHub 服務(wù)器在國(guó)外，如果網(wǎng)絡(luò)不好的話(huà)，嚴(yán)重影響使用體驗(yàn)，甚至?xí)霈F(xiàn)登錄不上的情況。

針對(duì)這個(gè)情況，可以使用國(guó)內(nèi)的項(xiàng)目托管平臺(tái)—— Gitee 碼云，來(lái)替代 Github 這個(gè)國(guó)外的項(xiàng)目托管平臺(tái)。

Gitee 碼云是開(kāi)源中國(guó)推出的基于 Git 的代碼托管服務(wù)中心，網(wǎng)址是 https://gitee.com 。

Gitee 的使用方式和 GitHub 基本一樣，此外它還是一個(gè)中文網(wǎng)站，如果英文不是很好的話(huà)，它是最好的選擇。

10.2、注冊(cè)Gitee賬號(hào)

如上圖所示，在 Gitee 碼云的首頁(yè)，點(diǎn)擊“注冊(cè)”按鈕，進(jìn)入注冊(cè)頁(yè)面。

如上圖所示，輸入注冊(cè)所需要的信息，然后發(fā)送驗(yàn)證碼到注冊(cè)的郵箱中。

如上圖所示，從注冊(cè)郵箱中找到驗(yàn)證碼，然后就可以完成注冊(cè)。

如上圖所示，注冊(cè)成功后，會(huì)自動(dòng)登錄跳轉(zhuǎn)到 Gitee 碼云的個(gè)人主頁(yè)。

10.3、創(chuàng)建遠(yuǎn)程倉(cāng)庫(kù)

如上圖所示，點(diǎn)擊“新建倉(cāng)庫(kù)”。

如上圖所示，設(shè)置倉(cāng)庫(kù)名稱(chēng)和倉(cāng)庫(kù)類(lèi)型，然后點(diǎn)擊“創(chuàng)建”按鈕，即可創(chuàng)建一個(gè)遠(yuǎn)程庫(kù)倉(cāng)庫(kù)。

注意：在 Gitee 碼云新建倉(cāng)庫(kù)時(shí)，倉(cāng)庫(kù)類(lèi)型不能直接選擇為開(kāi)源的；需要先選擇為私有的，然后再在“倉(cāng)庫(kù)設(shè)置”中修改為公開(kāi)的。

如上圖所示，倉(cāng)庫(kù)新建成功，可以獲取到這個(gè)倉(cāng)庫(kù)的 HTTPS 和 SSH 地址。

注意：因?yàn)?Gitee 碼云的服務(wù)器在國(guó)內(nèi)，所以推薦使用遠(yuǎn)程庫(kù)的 HTTPS 地址。

10.4、IDEA集成Gitee碼云

10.4.1、安裝Gitee碼云插件

如上圖所示，在“File”->“Settings”->“Version Control”中可以看到，IDEA 默認(rèn)沒(méi)有和 Gitee 的相關(guān)的功能，因此需要額外安裝 Gitee 插件。

如上圖所示，在“Plugins”->“Marketplace”中，搜索“gitee”，即可找到 Gitee 插件來(lái)安裝。

如上圖所示，接受安裝第三方插件。

如上圖所示，安裝完成插件后，需要重啟 IDEA 才能使用該插件。

如上圖所示，Gitee 插件安裝成功后，可以在“Version Control”中找到和 Gitee 的相關(guān)的功能。

10.4.2、登錄Gitee賬號(hào)

如上圖所示，在“Version Control”->“Gitee”中，點(diǎn)擊“+”按鈕，在登錄彈窗中，輸入Gitee的賬號(hào)密碼直接登錄。

10.4.3、分享項(xiàng)目到Gitee

10.4.3.1、打開(kāi)分享彈窗

如上圖所示，點(diǎn)擊“VCS”->“Import into Version Control”->“Share Project on Gitee”，即可打開(kāi)分享項(xiàng)目到 Gitee 的彈窗。

10.4.3.2、設(shè)置遠(yuǎn)程庫(kù)屬性

如上圖所示，在彈窗中設(shè)置遠(yuǎn)程庫(kù)的名稱(chēng)（Repository name，默認(rèn)值和項(xiàng)目名一樣）及該遠(yuǎn)程庫(kù)在本地的別名（Remote，默認(rèn)值是gitee），一般上都設(shè)置成和本地庫(kù)的名稱(chēng)一樣（本例已將遠(yuǎn)程庫(kù)在本地的別名，修改為和本地庫(kù)的名稱(chēng)一樣但加了 gitee 前綴）。

此外，如果“Private”復(fù)選框被選中，則創(chuàng)建的遠(yuǎn)程庫(kù)是私有庫(kù)；默認(rèn)不選中，即創(chuàng)建的遠(yuǎn)程庫(kù)是公有庫(kù)。

注意：因?yàn)楸疚乃褂玫?Gitee 賬號(hào)沒(méi)有綁定手機(jī)，所以創(chuàng)建不了公有庫(kù)，因此選中了“Private”復(fù)選框。

10.4.3.3、分享操作效果

如上圖所示，在彈窗中點(diǎn)擊“share”按鈕（相當(dāng)于創(chuàng)建遠(yuǎn)程庫(kù)然后push操作）后，項(xiàng)目成功地被分享到 Gitee 。

如上圖所示，在 Gitee 中可以看到遠(yuǎn)程庫(kù)已存在。

10.4.4、推送更新到遠(yuǎn)程庫(kù)

10.4.4.1、在本地庫(kù)新增內(nèi)容

如上圖所示，新增了一行內(nèi)容；且經(jīng)過(guò)修改內(nèi)容后，已被 Git 追蹤過(guò)的文件顏色會(huì)變成藍(lán)色。

10.4.4.2、將更新提交到本地庫(kù)

如上圖所示，因?yàn)轫?xiàng)目所有的文件在之前已被追蹤過(guò)，所以可以將修改直接提交到本地庫(kù)。

如上圖所示，在提交彈窗中，可以看到將要提交到本地庫(kù)的文件有哪些變化。

在“Commit Message”中填寫(xiě)提交信息，然后點(diǎn)擊“Commit”按鈕，即可完成提交到本地庫(kù)的操作。

如上圖所示，當(dāng)修改后的文件被提交到本地庫(kù)后，文件的顏色恢復(fù)為最原始的黑色；且“Version Control”->“Log”界面也能看到提交信息。

10.4.4.3、將更新推送到遠(yuǎn)程庫(kù)（方式一）

如上圖所示，右擊項(xiàng)目名，然后點(diǎn)擊“Git”->“Repository”->“Push”，即可打開(kāi)推送彈窗。

注意：余下操作請(qǐng)參照方式二。

10.4.4.4、將更新推送到遠(yuǎn)程庫(kù)（方式二）

如上圖所示，點(diǎn)擊“VCS”->“Git”->“Push”，即可打開(kāi)推送彈窗。

如上圖所示，在推送彈窗中，會(huì)自動(dòng)使用到遠(yuǎn)程庫(kù)的別名。

10.4.4.5、推送操作效果

如上圖所示，點(diǎn)擊“Push”按鈕后，本地庫(kù)的更新成功地被推送到遠(yuǎn)程庫(kù)。

如上圖所示，在 Gitee 中可以看到遠(yuǎn)程庫(kù)已存在新的提交。

10.4.5、拉取更新到本地庫(kù)

要想 push 成功，一定要保證本地庫(kù)的版本要比遠(yuǎn)程庫(kù)的版本高！

因此一個(gè)成熟的程序員在動(dòng)手改本地代碼之前，一定會(huì)先檢查下遠(yuǎn)程庫(kù)跟本地代碼的區(qū)別！

如果本地的代碼版本已經(jīng)落后，切記要先 pull 拉取一下遠(yuǎn)程庫(kù)的代碼，將本地代碼更新到最新以后，然后再修改、提交、推送！

10.4.5.1、在遠(yuǎn)程庫(kù)新增內(nèi)容

如上圖所示，點(diǎn)擊文件的編輯按鈕，即可進(jìn)入編輯頁(yè)面在線(xiàn)修改遠(yuǎn)程庫(kù)的內(nèi)容。

如上圖所示，在編輯頁(yè)面修改完內(nèi)容后，填寫(xiě)提交信息，便可點(diǎn)擊“提交”按鈕，即可完成在遠(yuǎn)程庫(kù)提交的操作。

10.4.5.2、將更新拉取到本地庫(kù)（方式一）

如上圖所示，右擊項(xiàng)目名，然后點(diǎn)擊“Git”->“Repository”->“Pull”，即可打開(kāi)拉取彈窗。

注意：余下操作請(qǐng)參照方式二。

10.4.5.3、將更新拉取到本地庫(kù)（方式二）

如上圖所示，點(diǎn)擊“VCS”->“Git”->“Pull”，即可打開(kāi)拉取彈窗。

如上圖所示，在拉取彈窗中，可以選擇拉取哪個(gè)遠(yuǎn)程庫(kù)地址的更新。

10.4.5.4、拉取操作的效果

如上圖所示，點(diǎn)擊“Pull”按鈕后，遠(yuǎn)程庫(kù)的更新成功地被拉取到本地庫(kù)。

注意：拉取操作會(huì)自動(dòng)合并，如果自動(dòng)合并失敗，就需要手動(dòng)解決合并沖突的問(wèn)題。

10.4.6、克隆遠(yuǎn)程庫(kù)到本地

10.4.6.1、刪除本地庫(kù)

如上圖所示，因?yàn)樵擁?xiàng)目已經(jīng)托管（備份）到了遠(yuǎn)程庫(kù)，所以刪除后也能從遠(yuǎn)程庫(kù)克隆到本地。

10.4.6.2、使用IDEA克隆遠(yuǎn)程庫(kù)到本地

如上圖所示，在 IDEA 的初始化界面，點(diǎn)擊“Check out from Version Control”->“Git”，即可打開(kāi)克隆彈窗。

如上圖所示，在克隆彈窗中，輸入遠(yuǎn)程庫(kù)地址，點(diǎn)擊“Test”按鈕，看到連接成功的提示，即可點(diǎn)擊“Clone”按鈕將該遠(yuǎn)程庫(kù)克隆到本地。

如上圖所示，成功克隆遠(yuǎn)程庫(kù)到本地后，IDEA 會(huì)提示是否打開(kāi)該項(xiàng)目。

如上圖所示，項(xiàng)目的內(nèi)容和提交信息都能正?？寺?。

注意：如果在編譯運(yùn)行時(shí)報(bào)錯(cuò)“Error 錯(cuò)誤: 不支持發(fā)行版本 5”，請(qǐng)參考該解決方案。

10.5、Gitee復(fù)制Github項(xiàng)目

10.5.1、使用遠(yuǎn)程庫(kù)地址導(dǎo)入

如上圖所示，Gitee 碼云提供了直接復(fù)制 GitHub 項(xiàng)目的功能，方便我們做項(xiàng)目的遷移和下載。

如上圖所示，復(fù)制 Github 遠(yuǎn)程庫(kù)（https）地址，然后點(diǎn)擊“導(dǎo)入”按鈕，即可將該遠(yuǎn)程庫(kù)地址的 Github 項(xiàng)目復(fù)制到 Gitee 。

注意：在 Gitee 碼云新建倉(cāng)庫(kù)時(shí)，倉(cāng)庫(kù)類(lèi)型不能直接選擇為開(kāi)源的；需要先選擇為私有的，然后再在“倉(cāng)庫(kù)設(shè)置”中修改為公開(kāi)的。

如上圖所示，已成功將 Github 項(xiàng)目復(fù)制到 Gitee 。

10.5.2、強(qiáng)制同步功能

如上圖所示，GitHub 項(xiàng)目的內(nèi)容有更新。

如上圖所示，在 Gitee 倉(cāng)庫(kù)名稱(chēng)旁邊，點(diǎn)擊一個(gè)刷新按鈕，即可將 Github 倉(cāng)庫(kù)的更新同步到 Gitee 倉(cāng)庫(kù)。

如上圖所示，在同步彈窗中，會(huì)提示 Gitee 倉(cāng)庫(kù)會(huì)被覆蓋。

如上圖所示，強(qiáng)制同步成功。