圖文全攻略!Git版本控制與 GitHub協作

在程式開發或網頁設計的過程中,版本控制是一個非常重要的技能。無論你是軟體工程師、網頁設計師、資料分析師,還是學生,學會使用 Git 和 GitHub 都能幫助你更好地管理專案、協作開發,並確保資料的安全備份。本文將一步步帶你從零開始,學會如何使用 Git 和 GitHub,讓你能夠輕鬆掌握版本控制的要訣!


第一步:安裝必要的工具

1. 安裝 VS Code

VS Code 是一個免費且開源的程式碼編輯器,支援多種程式語言,並且有豐富的擴充功能。我們將使用它來進行 Git 的操作。

  • 下載 VS Code:前往 VS Code 官方網站,選擇適合你作業系統的版本(Windows、Mac 或 Linux)進行下載。
  • 安裝 VS Code:下載完成後,雙擊安裝程式並按照指示完成安裝。

2. 安裝 Git

Git 是一個版本控制工具,我們需要先將它安裝到電腦上。

Windows 用戶

  • 下載 Git:前往 Git 官方網站,下載最新版的 Git 安裝程式。
  • 安裝 Git:雙擊下載的安裝程式,然後一直按「下一步」即可完成安裝。

3. 檢查 Git 是否安裝成功

  • 打開 VS Code,點擊左上角的「終端機」選單,選擇「新增終端」。
  • 在終端機中輸入以下指令:git --version
  • 如果畫面中顯示 Git 的版本編號(例如 git version 2.33.0),表示 Git 已成功安裝。
確認Git是否正確安裝
確認Git是否正確安裝

第二步:設定 Git

在使用 Git 之前,我們需要先設定姓名和電子郵件地址,這樣 Git 在記錄版本變更時才能知道是誰做的修改。

  • 在終端機中輸入以下指令來設定姓名:git config --global user.name "你的姓名"
  • 接著設定電子郵件:git config --global user.email "你的電子郵件"

第三步:建立 Git 儲存庫

現在我們要將一個普通的資料夾轉換成一個具有版本控制功能的 Git 儲存庫。

  1. 在桌面新增一個資料夾,命名為”my_project”
  2. 複製資料夾的檔案路徑
  3. 在終端機中輸入以下指令來初始化 Git 儲存庫:cd "C:\Users\acer\OneDrive\桌面\my_project" git init
    • 這個指令會在當前目錄中建立一個隱藏的 .git 資料夾,用來儲存檔案的變更歷史。想像這個資料夾就像一個時光機的引擎,記錄著每一次的變更!
建立Git儲存庫
建立Git儲存庫

第四步:開始使用 Git 進行版本控制

1. 建立檔案並追蹤變更

  • 在 VS Code 中,點擊左側的「新增檔案」按鈕,建立一個新的檔案(例如 README.md)。
  • 檔案的儲存位置記得放在你剛剛建立的資料夾!(my_project)
  • 在檔案中輸入一些內容,然後按下 Ctrl + S 儲存。
  • 在終端機中輸入以下指令來檢查檔案的狀態:git status
    • 你會看到剛剛建立的檔案被標記為「未追蹤」(Untracked),這表示 Git 還沒有開始追蹤這個檔案的變更。就像一個新模特兒還沒進入攝影棚!
確認檔案狀態
確認檔案狀態

2. 將檔案加入暫存區

  • 在終端機中輸入以下指令,將檔案加入暫存區(Staging Area):git add README.md
    • 如果你有多個檔案,可以使用 git add . 來將所有變更加入暫存區。這就像把所有模特兒都請進攝影棚,準備拍照!

3. 提交變更

  • 在終端機中輸入以下指令來提交變更:git commit -m "第一次提交,新增 README.md 檔案"
    • -m 後面的是提交訊息,用來簡述這次提交的內容。這就像為每張照片加上標題,方便以後查找。
提交變更
提交變更

4. 查看提交歷史

  • 在終端機中輸入以下指令來查看提交歷史:git log
    • 你會看到每次提交的詳細資訊,包括提交者、日期和提交訊息。這就像翻開一本相簿,回顧每一張照片的拍攝時間和地點!
    • 如果想簡化顯示,可以使用 git log --oneline
查看提交歷史
查看提交歷史

此處的(HEAD -> master)是什麼意思?

  1. HEAD 是你的書籤
    HEAD 就像你在筆記本裡放的書籤,標記你現在讀到哪一頁。
  2. master 是你的主要筆記
    master 就像是你這本筆記的主要章節名稱,你正在這個章節裡寫東西。
  3. HEAD -> master 的意思
    你現在的書籤 (HEAD) 放在 master 這一章的最後一頁,而你正在 master 這個章節寫筆記。你可能會問:除了master以外,我還可能有其他的”章節”嗎?這就要談到我們下一段要講的”branch”

補充:Git的追蹤狀態

Git有分為以下幾種狀態:

狀態代表意思如何處理
UntrackedGit 沒有追蹤的檔案git add 讓 Git 追蹤
Modified已追蹤但被修改的檔案git add 暫存變更
Staged變更已暫存但未提交git commit 提交變更
Committed變更已提交並存入版本庫git push 推送到遠端
Ignored.gitignore 忽略的檔案.gitignore 設定忽略規則

常見的流程為:

1️⃣ Untracked(Git 不知道這個檔案)
🔽 git add
2️⃣ Staged(Git 知道這個變更,準備提交)
🔽 git commit -m “描述變更”
3️⃣ Committed(Git 已經正式記錄這個變更)


第五步:將專案上傳至 GitHub

1. 在 GitHub 建立新的儲存庫

  • 前往 GitHub
  • 點擊右上角 「Create repository」
  • 命名你的專案,例如 my_project
創建Github專案
創建Github專案

2. 連結 GitHub 遠端儲存庫

複製Github專案網址
複製Github專案網址
  • 複製連結,在終端機輸入以下指令,將本地專案與 GitHub 連結:git remote add origin 你複製的連結
  • 確保遠端已設定正確:git remote -v

3. 將本地變更推送到 GitHub

  • 推送 master 分支到 GitHub:
git push -u origin master
推送變更到Github
推送變更到Github

初次連結Git的用戶,應用程式會跳出Github的登錄介面,記得先依照指示連結喔!


第五步:使用分支進行協作開發

分支(Branch)是 Git 的強大功能之一,它讓多人協作開發變得更加順暢。想像分支就像平行宇宙,你可以在裡面自由開發,而不會影響主線!

1. 建立新分支

  • 在終端機中輸入以下指令來建立一個新分支:git branch feature/new-feature
    • feature/new-feature 是分支的名稱,你可以根據功能或任務來命名。
  • 切換到新分支:git checkout feature/new-feature
    • 或者你可以用以下指令一步完成建立並切換分支:
      bash git checkout -b feature/new-feature這會創建一個名為 new-feature 的新分支,並自動切換到這個分支。

2. 在新分支上進行開發

  • 在新分支上進行你的開發工作,例如修改原本的README檔案、新增功能等。
  • 完成後,將變更加入暫存區並提交:git add . git commit -m "新增新功能"

3. 將分支推送到 GitHub

  • 將本地分支推送到 GitHub:git push origin feature/new-feature

第六步:發起 Pull Request(PR)

1. 在 GitHub 上發起 PR

發起Pull Request
發起Pull Request
  • 打開 GitHub 的專案頁面。
  • 你會看到「Compare & pull request」按鈕,點擊它。
  • 填寫 PR 的標題和描述,說明你做了哪些修改。
  • 點擊「Create pull request」。

2. 合併 PR

合併Pull Request
合併Pull Request
  • 當 PR 通過審查後,點擊「Merge pull request」按鈕,將分支合併到 master
  • 合併後,可以回到Branches刪除*feature/new-feature 分支,以保持儲存庫整潔。

第七步:同步遠端變更

當多人協作時,你需要拉取最新變更,確保你的本地儲存庫是最新的。

git checkout master
git pull origin master
同步遠端變更
同步遠端變更

總結

今天帶大家解釋了Git與Github的功能與工作流程,如果你是軟體PM、技術寫手,或任何需要跟工程師密切合作的人員,Git都是不可多得的代碼管理好幫手!

如果對操作有不清楚的地方,可以到社群密我!

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *