每次新连接GitHub,总会给人带来意想不到的糟糕体验。经过反复的建立与删除仓库,我总结出以下步骤以供参考。
(如果以下用到的工具没有安装,执行sudo apt install <tool-name>即可)
- 建立GitHub远程仓库。这个没什么好说,直接建就完了。
- 建立本地仓库。这一步需要做的是:
- 建一个空文件夹,名字记为<filename>
- 将目录切到<filename>下,执行git init,将此处初始化为一个仓库
- 执行git add .,跟踪目录下所有文件
- 执行git config --global init.defaultBranch main,将初始化时默认分支改名为main,与GitHub上保持一致
- 执行git branch -m main,将分支切换到main;这一步可有可无
- 执行git remote add <url-name> <url>,其中<url-name>不一定是网上说的origin,可以是与当前仓库相关的一个名字。url要么是HTTPS的url,要么是SSH的url。由于某些不可言说的原因,HTTPS可能连接失败,所以我用的是SSH
- 配置SSH密钥。这一步需要做的是:
- 在任意目录下执行ssh-keygen -t <key-type> -C <host-info>,创建一个指定类型的密钥;听说ed25519比较先进,于是我的<key-type>用的是ed25519;<host-info>用于标识当前主机,不影响密钥,随便填写信息即可,我写的是"LAPTOP-WSL-UBUNTU",注意要带引号
- 将目录切到~/.ssh下,可看到两个文件id_ed25519和id_ed25519.pub
- 执行cat id_ed25519.pub,将输出的内容复制
- 进入Sign in to GitHub · GitHub,点击new SSH key,将复制的内容粘贴到Key区域,Title随便取,然后点击Add SSH key即可
- 执行ssh -T git@github.com,回车后输入yes(一定不要直接回车跳过),然后一路回车到连接成功
- 如果远程仓库里有README.md和LICENSE,需要先把仓库里的文件pull下来,这一步需要做的是:
- 执行git config pull.rebase false,设置策略为合并
- 再执行git pull <url-name> main,拉取远程仓库的内容
- 将新增的文件上传到远程仓库,这一步需要做的是:
- 执行git commit -m <msg>,将变更先提交到本地仓库;<msg>的写法有一定的规范,不过第一次一般可以写"initial commit"之类的
- 执行git push <url-name> main,将本地仓库推送到远程仓库
至此圆满成功。