当前位置：首页 > article >正文

Git使用（二）--如何配置 GitHub 远程仓库及本地 Git 环境

article 2026/3/10 3:46:52

在日常的开发过程中，使用版本控制工具 Git 是一个非常重要的技能，特别是对于管理和协作开发。通过 GitHub，我们可以轻松地进行代码版本管理和共享。这篇博客将带您一步步学习如何配置 Git 环境并将本地仓库与 GitHub 远程仓库连接起来。

一、安装 Git Bash 并创建 GitHub 仓库

未安装Git Bash可参考Git使用（一）--如何在 Windows 上安装 Git：详细步骤指南-CSDN博客

首先，确保已经安装 Git Bash，打开 Git Bash 后，我们开始配置 GitHub 仓库。

打开 GitHub（https://github.com），登录后点击右上角的“New Repository” 创建一个新的仓库。建议为您的仓库命名，如 personalspace，并确保选择公开或私有仓库。
创建完仓库后，接下来的任务是在本地创建一个 Git 仓库并将其与 GitHub 远程仓库关联。

二、在本地创建版本库

接下来，我们需要在本地创建一个新的 Git 仓库。

在计算机上，新建一个文件夹，名称与 GitHub 上的仓库名称一致，例如 personalspace。

右键点击该文件夹并选择 “Git Bash Here” 选项，打开 Git Bash。
在 Git Bash 中输入以下命令初始化本地 Git 仓库：

git init

成功初始化后，您会发现文件夹中多了一个 .git 文件夹，这是 Git 用来管理版本控制的文件夹。
将您的项目或源代码复制到此文件夹中（后面进行上传）。

三、添加文件并提交Git ,对项目中的文件进行管理和版本控制。

首先，需要添加文件到暂存区。

1.使用以下命令查看文件状态：

git status

红色表示未添加到 Git 仓库，绿色表示已经添加。

2.使用以下命令将文件添加到暂存区：

git add .

这样就将当前目录下的所有文件添加到了 Git 的暂存区。

3.使用以下命令提交文件到本地仓库：

git commit -m "first commit"

四、配置 SSH 密钥

为了将本地仓库与 GitHub 远程仓库安全地连接，我们需要配置 SSH 密钥。

在 Git Bash 中输入以下命令设置您的用户名和邮箱：(这步没什么用)

git config --global user.name "注册名"//自定义用户名
git config --global user.email "注册邮箱"//用户邮箱

创建SSH Key

在用户主目录下，查询是否存在“.ssh”文件。

再看文件下有没有id_rsa和id_rsa.pub两个文件。SSH Key的秘钥对：id_rsa是私钥，不能泄露；id_rsa.pub是公钥，可以公开。
我们要使用的是其中的公钥id_rsa.pub

如果没有的话：生成SSH

git bash中输入指令：

ssh-keygen -t rsa -C "自己的邮箱"//邮箱是GitHub注册时使用的邮箱

SSH文件存放在C:/User/用户/.ssh下，id_rsa为私钥，id_rsa.pub为公钥。

红色三行出现时，直接回车即可。

执行完后，会在用户的主目录下生成 .ssh 文件夹，其中包含 id_rsa（私钥）和 id_rsa.pub（公钥）。

3.打开 GitHub，进入 Settings -> SSH and GPG Keys，点击 New SSH Key，将 id_rsa.pub 文件中的内容粘贴到文本框中。

title自定义，key复制id_rsa.pub的全部内容到文本框中

五、将本地仓库与 GitHub 远程仓库关联

1.验证是否成功，在git bash里输入下面的命令

ssh -T git@github.com

初次设置需要输入yes，出现第二个红框内容表示成功。

2. 回到 Git Bash，输入以下命令将本地仓库与 GitHub 上的远程仓库关联：

在GitHub代码仓库中找到SSH

git bash执行指令：（换成自己的SSH）

git remote set-url origin git@github.com:LiYuxuanDevSpace/personalspace.git

3. 然后使用以下命令将本地仓库推送到远程仓库：

由于新建的远程仓库是空的，所以要加上-u这个参数

git push -u origin master

之后仓库不是空的，就不用加上-u

git push origin master

六、总结

1.初始化本地仓库

git init

2.使用以下命令将文件添加到暂存区：

git add .

3.提交到本地仓库：

git commit -m "英文注释"

4.与GitHub建立连接

git remote set-url origin git@github.com:LiYuxuanDevSpace/personalspace.git

5. 将本地仓库推送到远程仓库：

git push -u origin master