[git版本控制]github平台创建项目,克隆到本地进行后续的开发(从上到下)

15 阅读3分钟

整体步骤如下

  1. 检查本地是否已安装git(及:是否有了git客户端),如果没有则先安装git。
  2. 配置本地git的全局用户信息(用户名和邮箱)。
  3. 生成SSH密钥对(公钥和私钥)。
  4. 注册github账户, 并在github平台创建项目
  5. 将公钥添加到GitHub账户级别的ssh key列表中.
  6. 克隆远程仓库到本地。
  7. 生成readme.md文件和.gitignore文件, 通过git add git commit, git push -u origin main推到远程仓库.

注意:以下步骤假设你使用的是类Unix系统(如Linux或macOS),但Windows下的Git Bash操作类似。

1/检查并安装git

打开终端,输入以下命令检查git是否已安装:
git --version
如果未安装,请根据你的操作系统安装git。


2/配置全局用户信息

在终端中执行以下命令,将你的GitHub用户名和邮箱配置到git中:
git config --global user.name "你的GitHub用户名"
git config --global user.email "你的GitHub注册邮箱"

git config --global push.default current
git config --global --list # 查看所有的全局配置参数


3/生成SSH密钥对(公钥+私钥)

<1>方式1:ssh-keygen -t ed25519 -C "gitHub注册邮箱"

在终端中执行该命令生成SSH密钥:
执行后,会提示你选择密钥保存路径,默认按回车即可(保存在~/.ssh目录下)。
接着会提示你输入一个密码来加密你的私钥(可选,直接回车表示不设密码)。

<2>方式2:ssh-keygen -t rsa -b 4096 -C "github注册邮箱邮箱"

在终端中执行该命令生成SSH密钥:
执行后,会提示你选择密钥保存路径,默认按回车即可(保存在~/.ssh目录下)。
接着会提示你输入一个密码来加密你的私钥(可选,直接回车表示不设密码)。


4/将公钥添加到GitHub账户

首先,查看并复制你的公钥内容(假设使用默认路径):
cat ~/.ssh/xxx.pub
复制输出的全部内容。
然后,登录GitHub,点击右上角头像,选择"Settings" -> "SSH and GPG keys" -> "New SSH key"。
在"Title"中为这个密钥起一个名字(比如"My Computer"),在"Key"中粘贴刚才复制的公钥内容,最后点击"Add SSH key"。
你会看到你是有read/write权限的, 及读写权限.
读权限代表你可以执行git pull命令, 写权限代表你可以执行git push


5/在github平台创建项目

创建项目, 包括项目的描述, 是公开的还是私有的.
在创建项目的时候, 最好先不用初始化 README.md 文件和.gitignore文件.\


6/克隆远程仓库到本地

在GitHub上打开你的项目仓库,点击绿色的"Code"按钮,选择"SSH"选项,复制提供的SSH地址(类似:git@github.com:用户名/仓库名.git)。
然后在终端中,进入你希望存放项目的目录,执行克隆命令:
git clone git@github.com:username/project_name.git
这个时候, 你的本地是没有任何分支的, 你执行git branch命令发现啥也没有 如果你在生成密钥时设置了密码,那么第一次使用时会提示你输入密码。


7/本地开发, git push到远程

cd project_name

git init

touch readme.md

touch .gitignore

git add readme.md git add .gitignore

git commit -m "add readme.md .gitignore"

执行完以上命令之后, 你的本地就有master或main分支了, 一般是main分支.

最后git push -u origin main 这样就推到远程仓库了, -u就是--upstream, 上游绑定

你到github平台看下, 就能看到远程仓库的main分支, 以及readme.md文件和.gitignore文件.


总结

完成以上步骤后,你就成功将远程仓库克隆到本地了。

注意:如果你之前已经生成过SSH密钥,并且已经添加到GitHub账户的ssh key列表中了,那么可以跳过步骤3和步骤4。