整体步骤如下
- 检查本地是否已安装git(及:是否有了git客户端),如果没有则先安装git。
- 配置本地git的全局用户信息(用户名和邮箱)。
- 生成SSH密钥对(公钥和私钥)。
- 注册github账户, 并在github平台创建项目
- 将公钥添加到GitHub账户级别的ssh key列表中.
- 克隆远程仓库到本地。
- 生成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。