[github] 上传本地repo

本地已有的 Git 仓库推送到 GitHub 非常简单。以下是完整、稳妥的操作步骤：

📦 步骤 1：在 GitHub 创建空仓库

登录 GitHub，点击右上角 + → New repository

填写仓库名称（Repository name）

选择 Public（公开）或 Private（私有）

⚠️ 重要：不要勾选 Add a README file、.gitignore 或 License（保持仓库为空，避免后续合并冲突）

点击 Create repository

创建完成后，GitHub 会显示一组命令，其中 HTTPS 或 SSH 地址

cd /你的/本地/项目路径
git remote add origin https://github.com/<你的用户名>/<仓库名>.git
git push -u origin <你的分支名>

💻 步骤 2：在本地终端操作

打开终端（命令行），进入你本地项目的根目录：

cd /path/to/your/local-repo

确认当前所在分支（通常是 main 或 master）

git branch --show-current

🔗 步骤 3：关联远程仓库并推送

查看本地Git配置的用户名

# 查看当前仓库的本地配置
git config user.name
git config user.email

# 查看全局配置（所有仓库默认使用）
git config --global user.name
git config --global user.email

# 1. 添加 GitHub 仓库为远程源（origin 是默认名称）
git remote add origin https://github.com/你的用户名/仓库名.git
# （如果使用 SSH，替换为 git@github.com:你的用户名/仓库名.git）

# 2. 推送到 GitHub（替换 main 为你的实际分支名）
git push -u origin main

-u 参数会将本地分支与远程分支关联，之后只需 git push 即可。

✅ 步骤 4：验证

刷新 GitHub 仓库页面，确认代码已成功上传。

🔍 常见问题 & 注意事项

1. 验证当前账号ssh -T git@github.com，或者github.com可以替换成你在config里书写的自定义名称例如github-your-name（当你使用自定义的local authorization）
2. 如果出现failed to push some refs to ...可能是你的branch name写错了，有时候会默认是master 而不是 main.
3. 更改url的命令为git remote set-url origin git@github.com:...
4. 删除已经追踪的文件为git rm --cached your_file 或者git rm -r --cached data，其中-r 在删除文件夹的时候使用