Day27｜在 GitHub 上建立专案与使用 git push 指令将档案上传到 GitHub

先前介绍了很多关於 Git 的常用指令以及使用情况，但目前我们都只是在本地端操作而已，如果需要跟别人共同制作专案，或是想要传送到开放空间请教各个写 Code 大师，这时候我们就会需要 Push 到远端数据库啦！

现在最常听见与使用的远端数据库是 GitHub ，接下来就让我们慢慢了解 GitHub 是什麽，我们又要怎麽把我们的档案传送到 GitHub 呢？

GitHub 是什麽？

简单来说，GitHub 就是一个提供存取 Git 的站点、远端数据库，可以将自己写好的专案分享上传。

但要注意的是！Git 跟 GitHub 两个完全是不一样的东西唷！

👉 Git 被作为工具，让我们执行档案的管理并提交到储存库；而 GitHub 则是一个网站，本体是一个 Git Server ，提供除了基本的存取站点，也提供一些社群功能。

GitHub 是一个由 GitHub 公司所建立的网站，同时提供付费帐户与免费帐户，让使用着可以在这个 Git Server 建立自己的数据库，并存取保管中的代码。而相较於其他的 Git Server ，GitHub 还有一个特点是它类似於一个社群网页，拥有追踪（ Fallow ）、按赞（ Star ）其他使用者、数据库有谁参与并追踪最新版本，也有评论并提供复制（ Fork ）专案给予其他人的专案建议，而其他人同样也可以回馈给你的专案。

除此之外，提醒 GitHub 的 G 跟 Ｈ 都是大写英文喔！

设定属於自己的 GitHub 空间！

了解 GitHub 是什麽以後，接下来就动手将我们的专案 Push 上去吧～

Step 1 - 注册 GitHub

到 GitHub 官网注册会员。

注册完後，点击 Profile ，可以进入个人的 GitHub 页面。

Step 2 - 在 GitHub 建立新的数据库

当要上传档案时，我们需要在 GitHub 开新的专案。

可以点选右上角会员头贴的下拉选单，选择「Your Repositiories」後进入页面，再点选 「 New 」新增专案。

或是旁边的 + 号也可以选择 「New repository」

之後就会进入到 Creat a new repository 的页面：

填写专案名称、选择存取权限、按下 Creat repository 完成新增专案。

接下来会导入到以下这个画面：

页面说明｜

• creat a new repository on the command line - 适用於全新开始
• push an existing repository from the command line - 上传现存专案

接下来可以先把网址复制起来，後续步骤会用到。

Step 3 - 将档案上传到 Push

假设我们目前什麽都没有，要找一个空的目录。

因此我们跟着 create a new repository on the command line 这个步骤执行指令：

1. 建立一个 README.md 档案

$ echo "# Vue_Todolist" >> README.md # 建立一个 README.md 档案

2. git init 指令建立 Git 版本控制

$ git init # 进行版本控制

3. 将 README.md 档案加至暂存区

$ git add README.md # 将 [README.md](http://README.md) 档案加至暂存区

4. 提交到数据库

$ git commit -m "first commit"

5. 建立分支

$ git branch -M main

6. 将档案推上远端数据库 ｜设定一个端节的节点

   $ git remote add origin https://github.com/cycChuyin/Vue_Todolist.git
   

   • git remote 指令 - 跟远端有关系的操作（ remote ，远端之意）
   • add 指令 → 加入一个远端的节点
   • origin 为指向位置的代名词，这里代表後面提供的服务器位置（此位置与我们先前复制的相同）。

   

7. 将档案推上远端数据库 ｜git push

   设定好节点後，可以将档案 push 上去

   $ git push -u origin main
   

   说明 Push 指令：

   • 将 main 这个分支的内容推向 origin 这个位置。

   先前 origin 已经有代指我们 GitHub 要上传的位子

   • origin 如果没有 main ，则自动建立一个同样叫做 main 的分支。如果本来就有 main 分支，则会将此分支指向最新进度。
   • -u 参数，设定 upstream。

   

   执行 Push 指令时，可能会要求你输入 GitHub 的帐号密码。而这里的回馈讯息是说会需要一个 token ，可以根据讯息回馈来操作。
   Token authentication requirements for Git operations - 说明为何遇到这种情况及解决方式如何进行。
   Creating a personal access token - 後续跟着指示操作，得到金钥以後便可以回到 Git 继续操作。

   

   之後回到页面上重新整理：

   

   看到这个档案代表专案建立成功啦！

   之後也可以跟着这些步骤继续上传新的版本～