以下是將本地文件夾與 GitHub 遠程倉庫綁定并進行日常操作的完整命令流程，特別針對你的需求（忽略數據集、偏好使用 rebase 保持主分支整潔）進行了優化：

一、初始設置（首次綁定）

1. 在本地項目文件夾初始化 Git 倉庫

   cd /path/to/your/local/folder  # 進入你的本地工作文件夾
   git init                       # 初始化本地倉庫
   

2. 創建 .gitignore 文件（關鍵：忽略數據集）

   # 創建并編輯忽略文件
   touch .gitignore# 用文本編輯器打開 .gitignore 并添加需要忽略的內容，例如：
   # 數據集文件夾
   datasets/
   data/
   # 可能的數據集文件格式
   *.csv
   *.json
   *.h5
   # Cursor 編輯器可能產生的臨時文件
   .cursor/
   

3. 將本地文件添加到暫存區并提交

   git add .                      # 添加所有文件（會自動排除.gitignore中的內容）
   git commit -m "Initial commit" # 首次提交
   

4. 關聯 GitHub 遠程倉庫

   # 替換為你的 GitHub 倉庫 URL
   git remote add origin https://github.com/your-username/your-repo.git
   

5. 將本地分支推送到遠程并建立關聯

   # -u 參數設置 upstream，后續可直接用 git push/pull
   git push -u origin main
   

二、日常工作流程（使用 rebase 保持主分支整潔）

1. 創建新分支進行開發

   # 確保當前在主分支且最新
   git checkout main
   git pull --rebase origin main  # 用 rebase 拉取遠程更新，保持線性歷史# 創建并切換到新分支（例如 feature/new-function）
   git checkout -b feature/new-function
   

2. 在新分支上開發并提交

   # 開發完成后提交更改
   git add .
   git commit -m "Add new function"
   

3. 定期與主分支同步（避免沖突）

   # 切換到主分支
   git checkout main
   # 拉取最新更新（rebase 方式）
   git pull --rebase origin main# 切回開發分支，將主分支的更新合并到當前分支（rebase 方式）
   git checkout feature/new-function
   git rebase main# 如果有沖突，解決后繼續
   git add .
   git rebase --continue
   

4. 將開發完成的分支推送到遠程

   git push -u origin feature/new-function
   

5. 完成開發后合并到主分支

   # 切換到主分支
   git checkout main
   # 再次確保主分支是最新的
   git pull --rebase origin main
   # 將開發分支合并到主分支（rebase 方式保持歷史整潔）
   git rebase feature/new-function
   # 推送到遠程主分支
   git push origin main
   

6. 刪除已合并的分支（可選）

   # 刪除本地分支
   git branch -d feature/new-function
   # 刪除遠程分支
   git push origin --delete feature/new-function
   

三、常用輔助命令

• 查看遠程倉庫信息

  git remote -v
  

• 修改遠程倉庫地址

  git remote set-url origin https://github.com/new-username/new-repo.git
  

• 查看分支狀態

  git status       # 查看當前分支狀態
  git branch -a    # 查看所有本地和遠程分支
  

• 放棄本地修改（謹慎使用）

  # 放棄工作區所有修改
  git checkout .
  # 放棄暫存區的修改（即撤銷 git add）
  git reset HEAD .
  

這種工作流程通過 rebase 保持了主分支歷史的線性和整潔，同時 .gitignore 文件確保了數據集等不需要上傳的內容不會被提交到遠程倉庫。在 Cursor 中，你可以直接使用內置的 Git 擴展來執行這些命令，通常通過界面上的按鈕或命令面板（Ctrl+Shift+P 或 Cmd+Shift+P）即可操作。

你需要在 GitHub 上先新建一個倉庫，然后才能將本地文件夾與遠程倉庫關聯。本地操作和遠程倉庫是相輔相成的，具體關系如下：

必須的步驟：先在 GitHub 上創建遠程倉庫

1. 登錄你的 GitHub 賬號
2. 點擊右上角「+」號，選擇「New repository」
3. 填寫倉庫名稱（建議與本地文件夾名稱一致）
4. 關鍵：不要勾選「Initialize this repository with a README」（保持倉庫為空）
5. 點擊「Create repository」

創建完成后，GitHub 會顯示這個空倉庫的地址（類似 https://github.com/你的用戶名/倉庫名.git），這個地址就是后續要用到的遠程倉庫地址。

為什么需要先創建遠程倉庫？

• git remote add origin <地址> 這個命令的作用是「告訴本地倉庫：你的遠程備份地址在這里」
• 如果你沒有在 GitHub 上創建倉庫，就沒有這個地址，本地的修改也就無處可推
• 本地倉庫只存在于你的電腦中，遠程倉庫才是真正的「云端備份」

完整流程梳理（含遠程倉庫創建）

1. 在 GitHub 上創建空倉庫 → 獲得遠程地址
2. 在本地文件夾執行初始化：git init
3. 創建 .gitignore 并添加忽略規則
4. 提交本地文件：git add . → git commit -m "首次提交"
5. 關聯遠程倉庫：git remote add origin <你的遠程倉庫地址>
6. 第一次推送到遠程：git push -u origin main

這樣操作后，你的本地文件夾就和 GitHub 遠程倉庫建立了綁定，后續只需在本地修改，然后用 git push 就能將改動備份到遠程了。

簡單來說：本地倉庫是你的工作區，遠程倉庫是你的備份區，兩者需要通過上述步驟建立連接才能協同工作。