Git使用入门:从配置到将项目上传到GitHub的完整教程
Git使用入门:从配置到将项目上传到GitHub的完整教程
本文将详细介绍Git的使用方法,从基本配置到将项目上传到GitHub的完整流程。无论你是Git初学者还是想要巩固基础知识,本文都将为你提供清晰的步骤和详细的说明。
前置准备工作
在开始使用Git之前,你需要确保已经完成了以下准备工作:
- 下载并安装Git:本文以Windows环境为例,具体安装步骤可以参考相关教程。
- 注册GitHub账号:我们将使用GitHub作为远程仓库,因此需要提前注册一个GitHub账号。
Git初始化配置
打开Git Bash,执行以下两条命令进行全局配置:
$ git config --global user.name "Name"
$ git config --global user.email "YourGithub@xx.com"
global
:全局配置,对所有仓库生效,最常用system
:系统配置,对所有用户生效
配置SSH密钥
SSH(Secure Shell)密钥是一种用于进行安全通信的加密密钥对。它由一对相关的密钥构成:私钥和公钥。私钥储存在本地机器上,而公钥则可以在服务器上进行配置。当你与远程服务器建立连接时,SSH密钥将用于验证您的身份,确保只有授权用户才能访问。
步骤1:生成SSH密钥对
$ ssh-keygen -t rsa -C "xxx@xxx.com"
此邮箱账号即Git初始化配置时填写的email(即GitHub邮箱)。执行该命令后出现如下信息:
这是提示输入密码进行验证,不用输入,敲三下回车即可出现如下界面:说明SSH密钥对生成成功
此时我们可以去目录C:\Users\yourUserName\.ssh
下查看:
id_rsa
为私钥,包含了用户的私密信息,该文件应该严格保密,不能与他人分享id_rsa.pub
为公钥,可以公开分享
步骤2:将公钥添加到远程服务器
一旦生成了SSH密钥对,我们需要将公钥添加到远程服务器上,以便进行身份验证。这个过程与我们正在使用的代码托管平台有关。本文使用GitHub为例进行说明:
登录GitHub,然后进入"Settings"
点击“SSH and GPG keys”,然后选择“New SSH key”。
将公钥id_rsa.pub
里的内容复制到“Key”中(注意是里面的全部内容都复制),"Title"可以自己起个名字
使用Git将一个项目上传到远程仓库
(1)创建本地仓库
首先需要创建一个本地的版本库(其实就是一个文件夹),选择一个合适的目录创建一个文件夹,本文在E盘下新建了一个"ThreadPool"文件夹作为示例。
然后在Git Bash中进入这个文件夹(使用基本的cd
命令,不再赘述),执行以下命令将这个文件夹变成Git可管理的仓库。
$ git init
(此时会发现该文件夹内多了一个".git"文件夹,它是Git用来跟踪和管理版本库的)
(2)把要上传到GitHub的文件全部复制到此文件夹中,
(3)将文件提交到缓冲区
然后执行以下命令,将文件提交到缓存区
$ git add .
注意:.
代表把这个文件夹下的文件全部提交,也可以通过git add 文件名
的方式提交指定的文件。
然后可以通过git status
命令查看现在的状态(也可以不看):
(4)将文件提交到本地仓库
执行命令git commit -m "这里可以写你的注释"
,把文件提交到本地仓库
(5)在GitHub上新建远程仓库,并将远程仓库与本地仓库进行关联
新建仓库:
- "Repository name"为仓库名字,命名最好与一开始创建的文件夹名称一致
- "Description"为仓库的介绍,如果你要上传你的项目代码,这里可以填写简单的项目介绍
- 勾选"Public"说明你的仓库是公开的,谁都可以看;勾选"Private"说明你的仓库是私有的,只有你自己可以看,不过是要收费的。我们勾选"Public"就ok
- 建议勾选"Add a README file",这是项目的重要文档,它的主要作用有:
- 提供项目的概述,包括其目的、功能和特点,让用户快速了解项目。
- 详细说明如何安装、配置和使用项目,帮助用户顺利上手
- 如果项目欢迎外部贡献,可以在 README 中包含贡献的说明和指南。
- 提供维护者的联系方式或支持渠道,方便用户反馈问题或提出建议。
- 展示项目的使用示例或界面截图,帮助用户更好地理解项目。
在GitHub上创建好仓库以后就可以和我们本地仓库进行关联了。
在Git Bash中执行以下命令关联本地仓库和远程仓库(还是在本地仓库文件夹下执行):
$ git remote add origin git@github.com:xykCs/ThreadPool.git
执行此命令后,你的本地 Git 仓库将能够与 GitHub 上的仓库进行交互,比如推送(push)和拉取(pull)代码。
(6)将本地仓库的内容推送到远程仓库
关联成功之后,我们就可以把本地库的内容推送到远程仓库(也就是GitHub)上了:
$ git push -u origin main
(由于新建的远程仓库是空的,所以需要加上-u
这个参数。如果仓库不是空的,加此参数会报错)
注意,这里可能会报错,报错信息:
The authenticity of host 'github.com (20.205.243.166)' can't be established.
ED25519 key fingerprint is SHA256:+DiY3wvvV6TuJJhbpZisF/zLDA0zPMSvHdkr4UvCOqU.
This key is not known by any other names.
Are you sure you want to continue connecting (yes/no/[fingerprint])?
不要按回车,输入yes即可。该报错信息的含义:
- 你首次连接到 GitHub,系统提示你确认主机的真实性。
- 提示显示了 GitHub 的 ED25519 密钥指纹,并询问你是否要继续连接。
- 输入 yes 后,GitHub 的主机密钥被永久添加到你的已知主机列表中。