将您本地的项目代码上传到一个私有的、别人看不见的 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 [您的私有仓库网址]
命令来获取这个项目了。