将本地已有项目代码首次推送到 Gitee 的完整步骤和命令

以下是将本地已有项目代码首次推送到 Gitee 的完整步骤和命令，按顺序执行即可：

---

📂 步骤 1：在项目根目录初始化 Git 仓库

# 进入你的项目文件夹
cd /path/to/your/project

# 初始化 Git 仓库（默认创建 master 分支）
git init

# 如果是新版 Git（默认创建 main 分支），想用 master 分支则加 -b 参数：
git init -b master

---

➕ 步骤 2：添加文件到暂存区

# 添加所有文件（包括隐藏文件）
git add .

# 如果只想添加特定文件（例如 .cpp/.py 等）
git add *.cpp *.py README.md

---

💾 步骤 3：提交代码到本地仓库

# 提交并添加描述（必填）
git commit -m "Initial commit: 项目首次提交"

---

🌐 步骤 4：在 Gitee 创建远程仓库

1. 登录 Gitee
2. 点击右上角 「+」→「新建仓库」
3. 填写仓库名（如 nettest），不要勾选 "初始化仓库" 和 "设置模板"
4. 点击「创建」

---

🔗 步骤 5：关联远程仓库

# 复制 Gitee 提供的 HTTPS 或 SSH 地址（推荐 HTTPS）
git remote add origin https://gitee.com/你的用户名/仓库名.git

# 如果是 SSH 地址（需提前配置密钥）
git remote add origin git@gitee.com:你的用户名/仓库名.git

---

🚀 步骤 6：首次推送代码

# 推送到远程 master 分支（如果本地是 main 分支则替换）
git push -u origin master

# 如果遇到分支不匹配错误（本地是 main，远程要 master）
git push -u origin main:master  # 将本地 main 推送到远程 master

---

✅ 验证推送成功

1. 刷新 Gitee 仓库页面，确认代码已出现
2. 终端执行以下命令检查状态：

   git remote -v                  # 查看远程仓库地址
   git log --oneline              # 查看提交历史
   git status                     # 确认工作区干净

---

⚠️ 常见问题解决

1. 推送被拒绝（远程有 README 等文件）

# 先拉取合并（强制覆盖谨慎使用！）
git pull origin master --allow-unrelated-histories
git push -u origin master

2. 想切换默认分支（如 master → main）

git branch -m master main        # 本地重命名
git push -u origin main          # 推送到远程
# 然后到 Gitee 仓库设置 → 修改默认分支为 main

3. 误加了大文件无法推送

# 删除缓存的大文件
git rm --cached 大文件路径
# 添加到 .gitignore 后重新提交
echo "大文件名" >> .gitignore
git add .gitignore
git commit -m "移除大文件"
git push

---

📌 关键注意事项

1. 首次推送前确保已提交（git commit）
2. 仓库地址区分 HTTPS（需输密码）和 SSH（需配密钥）
3. 分支名一致：本地和远程分支名建议相同（master/main）

---

执行完以上步骤后，你的本地代码就已成功同步到 Gitee。后续开发只需：

git add .
git commit -m "更新描述"
git push   # 简写（因为已设置过 -u）