一、注册 Github 账号
在 Github 官网 https://github.com/ 上注册账号,填写个人信息并验证邮箱。Github 是全球最大的代码托管平台,也是开源社区中最重要的一环,拥有庞大的用户群体和资源库。
二、创建新仓库
登入自己的 Github 帐户后,进入首页,点击『New repository』按钮,依次填入项目名称、简介和选择公开或私有。
填写完成后,点击『Create repository』按钮就可创建新仓库。
三、安装 Git 工具
Git 是一种版本控制工具,能够帮助我们管理代码。要把本地代码上传到 Github,需先在本地计算机上安装 Git 工具。
在 Windows 系统中,下载 Git 客户端安装程序,然后一路 Next 安装即可。
在 Linux 系统中,安装 Git 工具使用以下命令:
sudo apt-get update
sudo apt-get install git
在 macOS 系统中,可以使用 Homebrew 安装 Git 工具。需要先安装 Homebrew,具体可参考 Homebrew 官网 https://brew.sh/。
brew install git
四、在 Github 上新建 SSS
在 Github 上需要新建 SSH key 来认证允许本机访问 Github。可以使用以下命令来生成一个新的 SSH key:
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
其中 "your_email@example.com" 为 Github 上设置的邮箱地址。然后一路 Next 安装即可,让 Git 默认生成的目录为空,表示放在默认目录中。
五、向 Github 添加 SSH key
为了让 Github 认证我们的本机允许访问 Github ,我们需要把刚才生成的 SSH key 添加到 Github 的『SSH key』中。可以使用以下命令来查找 SSH key 信息:
cat ~/.ssh/id_rsa.pub
然后把结果复制到 Github 帐户的『SSH key』中。这样就完成了本机与 Github 的连接认证。
六、本地新建 Git 仓库
使用以下命令在本地计算机中新建一个 Git 仓库:
mkdir myProject
cd myProject
git init
执行第一行命令在根目录下创建了一个名为 myProject 的文件夹,之后进入到文件夹中,执行第二行命令,进行 Git 仓库初始化。
七、将本地文件添加到 Git 仓库
在完成 Git 仓库的初始化后,需要把本地的文件添加到 Git 仓库中。使用以下命令将文件添加到 Git 仓库中:
git add .
其中 '.' 为所有文件,也可以使用单个文件路径添加。
八、将添加的文件提交到本地仓库
使用以下命令将添加到 Git 仓库的文件提交到本地仓库:
git commit -m "add new project"
其中 'add new project' 是本次提交的注释。
九、将本地仓库关联到 Github 远程仓库
将本地计算机的 Git 仓库关联到 Github 远程仓库,通过以下命令实现:
git remote add origin git@github.com:user/repo.git
其中 git@github.com:user/repo.git 是 Github 远程仓库的地址,其格式为 git@github.com:用户名/仓库名.git 。
十、将本地仓库推送到 Github 远程仓库
在将本地仓库推送至 Github 远程仓库之前,先用以下命令将远程仓库内容合并到本地仓库:
git pull origin master --allow-unrelated-histories
该语句将远程 Github 仓库中一个叫 master 的分支拉取到本地仓库中,与现有分支进行合并。
接下来,我们使用以下命令将本地仓库推送至 Github 远程仓库:
git push -u origin master
其中 -u 表示在推送的同时,将本地仓库与远程仓库建立起关联。
十一、完成 Github 项目上传
最后一步,刷新 Github 远程仓库页面,就能看到我们上传的新项目了。
十二、总结
通过以上步骤,我们就基本完成了 Github 中上传项目的步骤。注册 Github 帐号,创建新仓库,安装 Git 工具,新建 SSH key 并添加到 Github 帐户的 SSH key 中,本地新建 Git 仓库,添加文件、提交到本地仓库,将本地仓库关联到 Github 远程仓库,并将本地仓库推送到 Github 远程仓库,最后刷新 Github 远程仓库页面,就上传新项目完成了。