2025 iThome鐵人賽
「 Flutter ：30天打造念佛App，跨平台從Mobile到VR，讓極樂世界在眼前實現！」
Day 3
「 Flutter Git 實戰入門篇—穿越到Coding世界的勇者啊，你需要這套神裝(1) 」

前言

昨天我們已經認識Git、Gitflow，今天我們要來實際操作
「如何在本機建立專案的儲存庫(Repository)」。
這就是我們在專案開發中的第一件護體神裝！
有了這件神裝，失手也能時光倒流、滿血復活！

Day3 文章目錄：
一、Git安裝
二、Git初始化建立本機儲存庫
三、Commit的操作步驟

一、Git 安裝流程(macOS)

• 安裝Homebrew

官網：
https://brew.sh/
簡介：
Homebrew是macOS主流的套件管理器，
將「下載、安裝、升級、移除、查版本與路徑」繁瑣的步驟自動化，
讓我們可以快速取得最新版且可控的開發工具(例如Git)。

1. 打開終端機 Terminal

2. Homebrew官網取得安裝指令

3. 終端機貼上安裝指令，按下Enter執行

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

4. Homebrew 安裝成功

==> Downloading and installing Homebrew...
remote: Enumerating objects: 100, done.
remote: Counting objects: 100% (63/63), done.
remote: Compressing objects: 100% (17/17), done.
remote: Total 100 (delta 46), reused 57 (delta 45), pack-reused 37 (from 3)
==> /usr/bin/sudo /bin/mkdir -p /etc/paths.d
==> /usr/bin/sudo tee /etc/paths.d/homebrew
/opt/homebrew/bin
==> /usr/bin/sudo /usr/sbin/chown root:wheel /etc/paths.d/homebrew
==> /usr/bin/sudo /bin/chmod a+r /etc/paths.d/homebrew
==> Updating Homebrew...
==> Installation successful!

5. 輸入指令，顯示Homebrew版本號，驗證安裝成功

brew --version
Homebrew 4.6.11

• 安裝Git

1. 終端機輸入安裝指令

brew install git

2. 輸入指令，驗證 Git 安裝成功

• 顯示Git版本號

git --version
git version 2.51.0            #Git版本號

• 列出已有的Git

type -a git                  
git is /opt/homebrew/bin/git  #homebrew版 Git
git is /usr/bin/git           #系統內建版 Git

• 顯示當前使用的Git

which git
/opt/homebrew/bin/git       #homebrew版 Git

Homebrew版Git更新快、版本可控，而且可與系統版Git共存。

二、Git 初始化建立本機(本地)儲存庫(Repository)

1. 從VSCode Flutter專案打開Terminal

2. 輸入指令 pwd 取得專案根目錄路徑

pwd
/Users/***/Desktop/Amitabha/amitabha  #念佛App專案根目錄 

3. 設定使用者資訊
--global：對本機當前使用者的所有 Git 儲存庫生效

git config --global user.name "你的名字" 
git config --global user.email 你的信箱@example.com

4. 設定預設初始分支名稱

git config --global init.defaultBranch main  
#設定預設初始分支名稱 main，可以自己決定命名 

5. 初始化

git init

6. 查看當前狀態

git status

因為才剛初始化，還沒有任何提交（No commits yet），
專案中的檔案都屬於 未追蹤（Untracked） 狀態，
Git 只是看到它們存在，但還沒納入版本控制。

未追蹤的檔案Git不會記錄這份檔案的內容變更和編輯歷史。
已追蹤才是已經納入版本控制。

No commits yet

Untracked files:
  (use "git add <file>..." to include in what will be committed)
        .gitignore
        .metadata
        README.md
        analysis_options.yaml
        android/
        ios/
        lib/
        linux/
        macos/
        pubspec.lock
        pubspec.yaml
        test/
        web/
        windows/

nothing added to commit but untracked files present (use "git add" to track)

三、Commit操作步驟

1. 把檔案加入暫存區(stage)

• git add . 是把當前資料夾的所有變更加入暫存。

git add .

• 只放入部分檔案的變更，例如：

git add ios/ .gitignore #例如 只放ios資料夾、檔案.gitignore

• 加錯也可以刪除，例如：

git restore --staged ios/ .gitignore

• 輸入指令 git status ，確認專案檔案已放入暫存區追蹤

git status

2. 提交紀錄(commit)

-m後面是 提交訊息（commit message）的主旨

git commit -m "chore: initial commit"  

commit 提交會把目前暫存區的內容保存成一張快照。
Git 概念上是保存整棵專案的快照；未變更的內容會重用先前物件，
而打包時也會做差異壓縮，所以提交版本多通常也不會造成容量暴增。

files changed = 變更的檔案數量 (新增或修改)
insertions(+) = 新增了多少行
create mode = 新增檔案，100644 代表一般檔（非可執行）

[main (root-commit) c95246d] chore: initial commit
 129 files changed, 4934 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 .metadata
 ...略

Day 3 重點回顧