將您本地的項目代碼上傳到一個私有的、別人看不見的 GitHub 倉庫,是進行云端協作(如使用 Google Colab)、版本控制和代碼備份的最佳實踐。這是一個非常重要的技能。
整個過程可以分為三個部分:
-
準備工作:在您的電腦上安裝 Git(如果您還沒有安裝的話)。
-
在 GitHub 網站上:創建一個新的私有倉庫,作為代碼的“云端之家”。
-
在本地電腦上:使用命令行將您的項目文件推送到這個云端倉庫。
下面是詳細的、一步步的操作指南。
第一步:準備工作 - 安裝 Git
首先,我們需要確認您的電腦上是否安裝了 Git 這個工具。
-
打開一個終端(可以是 CMD 或 Anaconda Prompt)。
-
輸入以下命令并回車:
Bashgit --version
-
檢查結果:
-
如果它顯示了一個版本號(如
git version 2.45.1.windows.1
),說明您已安裝 Git,可以直接跳到第二步。 -
如果提示“'git' 不是內部或外部命令...”,說明您需要安裝 Git。請訪問 Redirecting… 下載適用于 Windows 的安裝程序。在安裝過程中,使用所有默認設置一路點擊“Next”即可。安裝完成后,重新打開一個終端并再次用
git --version
檢查。
-
第二步:在 GitHub 網站上創建私有倉庫
現在,我們去 GitHub 為您的項目創建一個私有的“云端之家”。
-
登錄 GitHub:
-
在瀏覽器中訪問 https://github.com,登錄您的賬戶(如果沒有,請注冊一個)。
-
-
創建新倉庫:
-
點擊頁面右上角的
+
號,然后選擇New repository
(新建倉庫)。
-
-
填寫倉庫信息:
-
Repository name (倉庫名稱): 建議使用您的項目名,例如
PFLlib-master
。 -
Description (描述): (可選) 可以簡單描述一下您的項目,例如 “A library for Personalized Federated Learning research”。
-
Public / Private (公開/私有): 這是最關鍵的一步:請務必選擇
Private
(私有)。 這樣,只有您自己或您授權的人才能看到這個倉庫。 -
Initialize this repository with: (用以下內容初始化倉庫)
-
請暫時不要勾選 “Add a README file”、“Add .gitignore”、“Choose a license” 這三個選項。因為您本地已經有了一個完整的項目文件夾,我們將從本地直接上傳。如果在這里創建了文件,可能會在后續步驟中引起合并沖突。
-
-
-
創建倉庫:
-
點擊綠色的
Create repository
按鈕。
-
-
不要關閉頁面:
-
創建后,您會看到一個新頁面,上面有一些命令行指令。請保持這個頁面打開,因為我們馬上需要從這里復制一個重要的網址。
-
第三步:在本地電腦上上傳代碼
現在,我們回到您的電腦,通過命令行將 PFLlib-master
文件夾里的所有內容上傳上去。
-
打開終端并進入項目目錄:
-
打開一個終端(推薦使用“Anaconda Prompt”或“Git Bash”)。
-
使用
Bashcd
命令,導航到您本地的PFLlib-master
項目的根目錄。cd D:\local_copy\simulationsss\PFLlib-master
-
-
初始化 Git 倉庫:
-
在該目錄下,運行以下命令。這個命令只在項目第一次設置時運行一次。
git init
-
這會在您的文件夾里創建一個隱藏的
.git
目錄,用來跟蹤所有版本變化。
-
-
添加所有文件到暫存區:
Bashgit add .
-
這里的
.
代表“當前目錄下的所有文件和文件夾”。
-
-
創建第一個提交 (Commit):
-
將所有添加的文件打包成一個“提交”,并附上一條說明信息。
git commit -m "Initial commit of PFLlib project"
-
-
關聯本地倉庫與遠程 GitHub 倉庫:
-
回到您在瀏覽器中打開的 GitHub 倉庫頁面,找到 “...or push an existing repository from the command line” 這部分。
-
復制以 git remote add origin 開頭的那一行命令,它看起來像這樣:
git remote add origin https://github.com/YOUR_USERNAME/PFLlib-master.git
-
將其粘貼到您的終端中并回車。(請確保
YOUR_USERNAME
是您自己的用戶名)。
-
-
重命名主分支 (推薦):
-
GitHub 現在默認的主分支名叫
main
。為了保持一致,我們最好也將本地的主分支改名為main
。
git branch -M main
-
-
推送代碼到 GitHub (關鍵的上傳步驟):
Bashgit push -u origin main
-
輸入身份驗證信息:
-
當您執行
push
命令時,系統很可能會彈出一個窗口或在終端提示您輸入用戶名和密碼。
這里注意 由于電腦和github沒有建立連接需要先生成SSH密鑰對-CSDN博客 -
重要提示:GitHub 出于安全原因,已經不再支持使用常規密碼進行命令行操作。您在這里需要輸入的“密碼”,實際上是一個個人訪問令牌(Personal Access Token, PAT)。
如何創建個人訪問令牌 (PAT)?
a. 登錄 GitHub -> 點擊右上角頭像 -> Settings -> 左側菜單滾動到底部,選擇 Developer settings -> Personal access tokens -> Tokens (classic)。
b. 點擊 Generate new token -> Generate new token (classic)。
c. 給它一個描述(例如 VS Code Colab Access),設置一個過期時間(例如30天)。
d. 在 Select scopes 部分,勾選 repo 這個權限。這足以對倉庫進行所有讀寫操作。
e. 點擊頁面底部的 Generate token。
f. 立即復制生成的令牌字符串(它只會出現這一次!),它看起來像 ghp_...。在終端提示輸入密碼時,就粘貼這個令牌。
-
完成以上所有步驟后,刷新您的 GitHub 倉庫頁面,您就會看到所有的項目文件都已成功上傳!現在,您就可以在 Google Colab 中使用 !git clone [您的私有倉庫網址]
命令來獲取這個項目了。