IntelliJ IDEA 專案推送到 Gitee (Git@OSC) 完整操作指南

IntelliJ IDEA 專案推送到 Gitee (Git@OSC) 完整操作指南

前提條件

• 已在 Gitee 創建倉庫，獲取 HTTP/SSH 地址：https://gitee.com/username/repo.git
• 本地已安裝 Git（Windows 建議 Git for Windows）

方法一：IDE 內置 VCS 操作（推薦新手）

1. 打開專案 → VCS → Import into Version Control → Create Git Repository → 選擇專案根目錄
2. VCS → Git → Remotes → + 添加遠程：
   Name: origin | URL: https://gitee.com/username/repo.git
3. VCS → Git → Push → 選擇分支（master/main）→ Push
4. 首次推送需輸入 Gitee 賬號密碼（或配置 SSH Key 免密）

方法二：命令行補救（遇到 IDE 推送失敗時）

# 進入專案目錄
cd /path/to/project

# 若非 Git 倉庫，先初始化
git init
git add .
git commit -m "Initial commit"

# 關聯遠程倉庫
git remote add origin https://gitee.com/username/repo.git

# 拉取遠程歷史（若倉庫非空）
git pull origin master --allow-unrelated-histories

# 推送
git push -u origin master

常見問題排查

• 推送被拒絕：遠程有本地無的提交 → 先 pull --rebase 或 --allow-unrelated-histories
• 認證失敗：Windows 凭據管理器緩存舊密碼 → 控制面板清理 / 改用 SSH Key
• 大文件拒絕：Gitee 單文件限制 100MB → 使用 Git LFS 或清理歷史

替代策略：先 Clone 再開發

若反覆遇到推送問題：

1. 本地新建空目錄
2. git clone https://gitee.com/username/repo.git
3. 將現有代碼複製進克隆目錄
4. IDEA 打開該目錄 → 正常提交推送

最佳實踐

• 配置 .gitignore 排除 target/、.idea/、*.iml、logs/
• 使用 SSH Key 免密：ssh-keygen -t ed25519 → 公鑰加到 Gitee 部署鑰匙
• 分支策略：main 保護分支，功能開發走 feature/*，MR 合入