一、準備工作
1. 安裝 Git
- Windows：下載安裝包
- macOS：在終端運行
brew install git - Linux：
# Ubuntu/Debian
sudo apt update && sudo apt install git# CentOS/Fedora
sudo yum install git
2. 配置用戶信息（首次使用）
git config --global user.name "你的名字"
git config --global user.email "你的郵箱"
3. 創建代碼倉庫（本地）
# 1. 打開終端/命令提示符
# 2. 進入項目目錄
cd /path/to/your/project# 3. 初始化Git倉庫
git init
二、添加項目文件到Git
1. 創建 .gitignore 文件（重要！）
在項目根目錄創建 .gitignore 文件，內容示例：
# 忽略系統文件
.DS_Store
Thumbs.db# 忽略編輯器文件
.idea/
.vscode/
*.swp# 忽略Python虛擬環境
venv/
.env# 忽略編譯文件
__pycache__/
*.pyc
2. 添加文件到暫存區
# 添加所有文件（排除.gitignore中的文件）
git add .# 或者添加特定文件
git add file1.py file2.js
3. 查看當前狀態
git status
綠色文件表示已添加到暫存區，紅色文件表示未跟蹤
三、創建首次提交
git commit -m "項目初始提交"
四、創建遠程倉庫（以GitHub為例）
1. 創建GitHub賬號
訪問 github.com 注冊賬號
2. 創建新倉庫
- 點擊右上角 ? > New repository
- 填寫倉庫名稱（建議與項目名一致）
- 選擇 Public（公開）或 Private（私有）
- 不要勾選 “Initialize this repository with a README”
- 點擊 Create repository
五、連接本地與遠程倉庫
1. 獲取遠程倉庫URL
創建成功后，復制顯示的HTTPS或SSH URL：
https://github.com/你的用戶名/倉庫名.git
2. 添加遠程倉庫
git remote add origin https://github.com/你的用戶名/倉庫名.git
3. 驗證連接
git remote -v
# 應顯示：
# originhttps://github.com/你的用戶名/倉庫名.git (fetch)
# originhttps://github.com/你的用戶名/倉庫名.git (push)
六、推送代碼到遠程倉庫
git push -u origin main
第一次推送使用
-u參數設置跟蹤關系
七、后續開發工作流
1. 日常開發流程
# 1. 修改文件
# 2. 查看修改狀態
git status# 3. 添加修改到暫存區
git add 修改的文件名
# 或添加所有修改
git add .# 4. 提交更改
git commit -m "描述本次修改的內容"# 5. 推送到遠程
git push
2. 常用命令速查
| 命令 | 用途 |
|---|---|
git diff | 查看未暫存的修改 |
git log | 查看提交歷史 |
git pull | 拉取遠程更新 |
git branch | 查看分支 |
git checkout -b 新分支 | 創建新分支 |
八、重要注意事項
1. 避免上傳敏感信息
- 不要在代碼中包含密碼、API密鑰等
- 使用環境變量管理敏感信息
- 如果誤上傳了敏感信息：
- 立即刪除文件
- 修改所有相關密鑰
- 使用
git filter-branch從歷史記錄中清除
2. 提交規范
- 提交信息要清晰描述修改內容
- 使用動詞開頭：“添加”、“修復”、"更新"等
- 示例：
git commit -m "修復用戶登錄失敗的問題"
git commit -m "添加用戶管理模塊"
3. 分支管理策略
# 創建功能分支
git checkout -b feature/new-module# 開發完成后合并到主分支
git checkout main
git merge feature/new-module# 刪除已合并的分支
git branch -d feature/new-module
九、遇到問題怎么辦？
常見問題解決：
- 認證失敗：
- 使用SSH代替HTTPS
- 生成SSH密鑰：
ssh-keygen -t ed25519 -C "your_email@example.com" - 將公鑰(~/.ssh/id_ed25519.pub)添加到GitHub賬戶設置
- 文件沖突：
# 拉取最新代碼時解決沖突
git pull
# 手動解決沖突后
git add 沖突文件
git commit -m "解決合并沖突"
- 撤銷修改：
# 撤銷未暫存的修改
git checkout -- 文件名# 撤銷已暫存未提交的修改
git reset HEAD 文件名
十、高級技巧（可選）
1. 使用Git GUI工具
- GitKraken
- Sourcetree
- VS Code內置Git功能
2. 設置自動化鉤子
在 .git/hooks 中添加腳本：
# pre-commit 示例（提交前運行測試）
#!/bin/sh
pytest tests/
if [ $? -ne 0 ]; then
echo "測試失敗，提交中止"
exit 1
fi
3. 使用Git LFS管理大文件
# 安裝Git LFS
git lfs install# 跟蹤大文件類型
git lfs track "*.psd"
git lfs track "*.mp4"
完整工作流示例
# 開始新功能開發
git checkout main
git pull
git checkout -b feature/user-profile# 開發過程...
git add .
git commit -m "添加用戶資料頁面"
git push -u origin feature/user-profile# 合并到主分支
git checkout main
git pull
git merge feature/user-profile
git push# 清理分支
git branch -d feature/user-profile
通過這套流程，即使是完全的新手也能安全高效地管理項目代碼。建議開始時先在一個測試項目上練習，熟悉后再應用到正式項目中。
