Git是什麼？簡單說，它是一個“版本控制系統”，就像一個“文件日記”，能幫你記錄文件的每一次修改，還能多人協作編輯。GitHub則是基於Git的“在線倉庫平臺”，你可以把本地的代碼存到GitHub上，也能和別人一起修改代碼。
一、準備工作¶
- 安裝Git：先在電腦上安裝Git工具。Windows用戶可以去Git官網下載，安裝時按默認選項一路下一步即可；Mac用戶可以用Homebrew（
brew install git）或直接官網下載。安裝完成後，打開終端（Windows用“Git Bash”），輸入git --version，如果顯示版本號，說明安裝成功。 - 註冊GitHub賬號：去GitHub官網註冊一個賬號，登錄後就可以創建倉庫了。
二、在GitHub上創建倉庫¶
倉庫就像一個文件夾，用來存放你的項目代碼。
- 登錄GitHub並創建倉庫
- 登錄後，點擊右上角的“+”號，選擇“New repository”（新建倉庫）。
- 填寫倉庫信息：- Repository name：倉庫名稱（比如“my-first-project”，只能用英文和數字，不能有空格）。
- Description：簡單描述（比如“我的第一個GitHub項目”，可選填）。
- Visibility：選“Public”（公開，所有人可見）或“Private”（私有，僅自己可見，免費用戶只能創建1個私有倉庫，新手先用Public）。
- 勾選“Add a README file”：自動生成一個說明文件（後續拉取時用，避免衝突）。
- 其他選項：暫時不用管（.gitignore和license可以後面再配置）。
- 點擊“Create repository”，倉庫就創建成功了。此時頁面會顯示倉庫地址（比如
https://github.com/你的用戶名/my-first-project.git），先複製下來備用。
三、本地項目關聯到GitHub倉庫¶
假設你的本地項目在文件夾“my-project”裏，裏面有文件（比如index.html、style.css）。
1. 初始化本地Git倉庫¶
打開終端，進入本地項目文件夾（比如Windows用cd C:\Users\你的用戶名\my-project，Mac用cd ~/my-project）。
輸入命令：git init
此時文件夾裏會出現一個隱藏的.git文件夾，說明本地倉庫初始化成功。
2. 關聯遠程GitHub倉庫¶
輸入命令：git remote add origin [剛纔複製的倉庫地址]
比如：git remote add origin https://github.com/你的用戶名/my-first-project.git
這一步是把本地倉庫和GitHub上的倉庫“綁定”，origin是遠程倉庫的別名（固定用origin即可）。
3. 拉取遠程倉庫內容（避免衝突）¶
如果GitHub倉庫裏有README文件（之前勾選了“Add a README”），需要先拉取遠程內容到本地，否則直接push會報錯。
輸入命令：git pull origin main（注意：現在很多倉庫用main分支，舊倉庫可能用master，如果報錯，換成master試試）。
如果拉取成功，本地就有了README文件，避免後續push時文件衝突。
4. 提交本地文件到GitHub¶
- 暫存文件：把本地修改的文件“打包”到暫存區，輸入
git add .（.表示所有文件，也可以寫具體文件名，比如git add index.html）。 - 提交到本地倉庫：給這次修改寫個“備註”，輸入
git commit -m "Initial commit"（引號裏是備註，比如“第一次上傳項目”）。 - 推送到遠程倉庫：把本地提交的內容推到GitHub，輸入
git push origin main。
此時，GitHub倉庫頁面就能看到你上傳的文件了！
四、基本命令速記¶
| 命令 | 作用 |
|---|---|
git init |
初始化本地Git倉庫（讓文件夾可被Git管理） |
git add . |
把所有修改的文件暫存到“準備提交區” |
git commit -m "..." |
把暫存區的文件提交到本地倉庫，"..."是備註內容 |
git push origin main |
把本地倉庫的內容推到GitHub的main分支 |
git pull origin main |
拉取GitHub倉庫的最新內容到本地（避免文件衝突） |
五、常見問題¶
- Q：提示“遠程倉庫已存在”？
A：可能是本地倉庫和遠程倉庫重複關聯了，先輸入git remote -v查看關聯的地址，然後用git remote remove origin刪除舊關聯，再重新add origin。 - Q：沒有README文件，push時報錯？
A：用git pull origin main拉取遠程倉庫的README（如果有），再提交。 - Q：需要多人協作？
A：後續可以學習git branch（分支）、git merge（合併）和git clone（克隆倉庫），但基礎階段先掌握“創建+提交”即可。
現在，你的本地項目已經和GitHub倉庫關聯成功，以後修改文件後，重複執行git add .→git commit -m "修改說明"→git push origin main，就能把更新推到GitHub上了！