「Antigravity 上傳 GitHub 教學｜解決 user.name 與 user.email 錯誤（Git 新手完整攻略）」

很多人在第一次使用 Antigravity 上傳 GitHub 專案時，常常會直接卡在 Git 設定畫面，尤其是看到「Make sure you configure your user.name and user.email in git」這段訊息時，更容易瞬間慌掉。其實這並不是錯誤，而是 Git 第一次使用前必須完成的基本初始化設定。這篇文章會從 0 開始，用最簡單的方式帶你完整理解 Git、GitHub 與 Antigravity 的運作方式，並一步一步教你完成 GitHub 專案上傳。

 

 

📖 文章目錄（點擊快速跳轉）

1. Git 是什麼？
2. GitHub 與 Antigravity 的關係
3. 為什麼會出現 user.name 錯誤？
4. 如何在 Antigravity 開啟 Terminal
5. 設定 Git 使用者資訊
6. git add、commit、push 是什麼？
7. GitHub Token 登入教學
8. 常見錯誤排除

1. Git 是什麼？為什麼大家都在用？

Git 是目前全世界最主流的版本控制工具。簡單來說，它就像是程式設計師的「時光機」與「存檔系統」。當你修改程式、網站或專案時，Git 可以幫你記錄每一次變化，未來如果改壞了，也能快速回復到之前的版本。

很多剛開始學程式的人，會以為 Git 是非常高深的技術，但其實它最核心的功能非常單純：

📦 備份版本

每次修改都能留下紀錄。

👥 團隊協作

多人同時開發也不容易衝突。

⏪ 還原功能

程式改壞時可以快速救回。

現在無論是網頁設計、AI 開發、Python 專案、Scratch 延伸專題，甚至很多學校資訊課程，都已經開始接觸 Git 與 GitHub。

2. GitHub 與 Antigravity 到底是什麼關係？

GitHub 可以理解成「程式碼版的 Google 雲端硬碟」。它專門用來存放 Git 專案。很多人會把網站、App、AI 專案或學習作品放到 GitHub 上。

而 Antigravity 則是一種線上開發環境。你不需要安裝很多複雜軟體，就能直接在瀏覽器中寫程式、開發網站、使用 AI 協助生成程式碼，甚至直接上傳到 GitHub。

但很多人會忽略一件事：雖然 Antigravity 幫你簡化了開發流程，但它底層其實還是使用 Git。因此第一次 push 到 GitHub 時，仍然需要完成 Git 的初始化設定。

3. 為什麼會出現 user.name 與 user.email 錯誤？

當你第一次輸入 git commit 時，Git 會詢問：「這份程式是誰提交的？」如果你沒有設定作者資訊，就會出現：

Make sure you configure your "user.name" and "user.email" in git.

這其實不是壞掉，而是 Git 還不知道你的身份。你只需要設定一次，以後所有專案都能沿用。

4. 如何在 Antigravity 開啟 Terminal？

很多新手最大的問題，不是 Git，而是不知道 Terminal 在哪裡。

通常在 Antigravity 的下方、左下角或側邊欄，會看到：

Terminal

點開之後，會出現類似黑色視窗：

$

這就代表你已經進入 Git 指令環境。

5. 正確設定 Git 使用者資訊

接著輸入以下兩行：

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

這裡的 Email，建議使用 GitHub 帳號綁定的 Email。因為 GitHub 會利用 Email 來辨識 commit 作者。

完成後，可以輸入：

git config --global --list

如果看到：

user.name=James
user.email=yourmail@gmail.com

代表設定成功。

6. git add、commit、push 是什麼？

很多人看到 Git 指令會頭痛，但其實最核心只有三個：

git add .

把修改加入準備提交區。

git commit

建立一次版本紀錄。

git push

把專案上傳 GitHub。

完整流程如下：

git add .
git commit -m "first commit"
git push

7. 為什麼 GitHub 現在不能直接用密碼？

以前 GitHub 可以直接輸入帳號密碼登入，但現在已經全面改成更安全的驗證方式，例如：

• Personal Access Token（PAT）
• SSH Key

新手最推薦使用 PAT。

建立方式可以到 GitHub 官方文件 查看。

當系統要求輸入 Password 時，不要輸入 GitHub 密碼，而是輸入 PAT Token。

8. 常見錯誤排除

Authentication failed

通常代表 GitHub 驗證失敗，請改用 Token。

Permission denied

可能登入錯帳號，或沒有 Repo 權限。

remote origin already exists

代表已經設定過遠端網址。

如果 remote 設定錯誤，可以改成：

git remote set-url origin https://github.com/你的帳號/專案.git

最後再重新 push 即可。

⚠️ 技術操作免責聲明

本文內容主要作為 Git 與 GitHub 基礎教學示範，實際操作流程可能因 Antigravity 版本、GitHub 驗證政策或個人開發環境不同而有所差異。進行 Git 操作前，建議先備份重要專案資料，避免誤操作導致檔案遺失。