github 上傳 git 專案

git 是一套版本控制的工具，可以幫助使用者簡單的執行版本控制
github 是目前 (2021) 最大的開源網站，這次要介紹的是如何從本機端上傳檔案到 github。雖然只有談到 github，不過如果你想要上傳檔案到 gitlab，步驟是非常相似的。

Windows git 安裝

先下載 git 檔案並安裝

Git — Downloading Package (git-scm.com)

一般選擇 64-bit Git for Windows Setup 下載安裝

安裝完成後，移動到需要版本控制的檔案資料夾內，按滑鼠右鍵，點選
git bash

開啟 git bash

會出現以下視窗，類似於 windows 的 cmd，或是 Linux 的 terminal

Ubuntu git 安裝

打開 terminal 輸入

sudo apt install git

安裝 git 完成後，移動到需要版本控制的檔案資料夾內，開啟 terminal

啟動 git

以下內容在 windows 上都輸入於 git bash 內

以下內容在 ubuntu 上都輸入於 terminal 內

第一次執行 git 者，需要設定使用者信箱和名稱

git config --global user.email "you@example.com"
git config --global user.name "Your Name"

以我為例

git config --global user.email "fishXXX@gmail.com"
git config --global user.name "fishXXX"

開始執行 git 版本控制，在視窗內輸入

git init

這會新增一個名為 .git 的資料夾，.git 是一個隱藏的資料夾，一般不會顯示

指定需要執行版本控制的資料，這些資料會被加入到 git 內

git add <file_name>

以我為例

git add ./test.md

如果想要指定所有現在位置以下的資料夾和檔案，執行

git add .

會將所有檔案加入版本控制中

觀察目前 git 狀況，可以看到有哪些檔案有被指定加入 git

git status

以 windows 為例，輸出如下

綠色是被加入 git 的檔案

紅色是沒有被加入 git 的檔案

執行 commit，更新所有加入 git 的檔案

git commit -m "your message"

-m 後方文字是這次 commit 的說明文字，可以簡單看出這次 commit 目的，可以依照個人需求修改文字內容。

以 windows 為例，執行後大致如下

完成檔案更新

生成 ssh key

SSH key 直接丟檔案到 github 上非常方便，在此敘述生成 SSH key 方法

windows 開啟命令提示字元 cmd，以下內容都輸入在 cmd 內

ubuntu 開啟 terminal，以下內容都輸入在 terminal 內

windows cmd 如圖

生成 SSH key

ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

以我為例

ssh-keygen -t rsa -b 4096 -C "fishXXX@gmail.com"

輸入後，會要求指定 SSH key 儲存位置

> Enter a file in which to save the key (/C/users/<user_name>/.ssh/id_rsa): [Press enter]

直接按 enter 就是使用預設位置

windows 預設位置在 C:\Users\<user_name>\.ssh\id_rsa

ubuntu 預設位置在 /home/<user_name>/.ssh/id_rsa

接下來要求設定密碼，不輸入直接按 enter 就表示不需要驗證碼

> Enter passphrase (empty for no passphrase): [Type a passphrase]
> Enter same passphrase again: [Type passphrase again]

如此完成 SSH key 生成

設定 github SSH key

開啟 github 網頁，找到個人頭像並點擊，找到 setting 進入

左側找到 SSH and GPG keys

找到 New SSH key

將新生成的 SSH key 加入，如果使用的是預設位置和檔名，可以從預設位置下的 id_rsa.pub 檔案取得 SSH key

打開 id_rsa.pub 檔，複製裡面所有的內容，貼在 github 的 SSH key 欄位

完成後按下 Add SSH key 完成 SSH key 加入 github

推送檔案到 github 上

github 上新增一個 repository

獲得以下畫面，找到 SSH 欄位按下去，獲得 SSH url

回到需要上傳檔案的資料夾下，也就是 .git 資料夾存在位置

windows 開啟 git bash，以下內容都輸入在 git bash

ubuntu 開啟 terminal，以下內容都輸入在 terminal

將加入到 git 且執行過 commit 的檔案推送到 github repository 上

第一次執行 git push 需要設定此 repository 為上游，分支 Branch 是 master

git push --set-upstream <SSH_url> master

以此例而言

git push git@github.com:mikethreeacer/test_git.git

以 windows 為例，執行後會看到以下畫面

重新整理 github 頁面，就可以看到上傳的檔案了

第一次 push 後，之後所有的 push 都可以簡化為

git push

就會自動推送 commit 到指定的 repository 上

指令總結

git init
git add <file_name>
git commit -m "your commit message"
git push --set-upstream <SSH_url> master

之後想要更新檔案可以使用如下指令

git add <file_name>
git commit -m "your new commit message"
git push