在当前目录下，直接创建公开仓库并推送（--source=. 表示使用当前文件夹）

一、完整流程（先建远程仓库，再连本地）

1. GitHub 网页上创建新仓库

1. 登录 GitHub，点击右上角「+」→ New repository

2. 填仓库名、公开 / 私有，不要勾选 Initialize this repository with a README（否则会有初始提交，和本地冲突，不过可以pull）

3. 点击 Create repository，得到远程仓库地址（HTTPS/SSH 都可以）

或者也可以命令行建仓库 如果需要完全脱离网页，可以用 GitHub 官方的命令行工具 gh（需提前安装并执行 gh auth login 登录）：

# 在当前目录下，直接创建公开仓库并推送（--source=. 表示使用当前文件夹）
gh repo create 仓库名 --public --source=. --remote=origin --push

# 如果只想创建仓库，不立即推送，去掉 --push 即可
gh repo create 仓库名 --private --source=. --remote=origin

2. 本地项目初始化并连接远程

# 1. 进入你的项目根目录（就是有.git的那个文件夹，或者新建的空文件夹）
cd /d/your_project_path

# 2. 初始化本地Git仓库
git init

# 3. 把文件交给Git管理
git add .

# 4. 第一次提交
git commit -m "first commit（就是贴个提交message，想写啥写啥）"

# 5. 把本地main分支和远程仓库关联（设置upstream）
# 注意把下面的地址换成你自己的GitHub仓库地址
git remote add origin https://github.com/你的用户名/你的仓库名.git

# 6. 把本地提交推送到远程main分支（首次推送必须加-u）
git push -u origin main

• 加 -u 的作用：把 origin main 设为当前本地分支的默认远程上游，之后再推送直接敲 git push 就行，不用每次都写 origin main。

[! note] 也可以用SSH关联仓库 前提是已经配置SSH密钥对，见三、配置 GitHub SSH 认证

# 5. 把本地main分支和远程仓库关联（设置upstream）
git remote add origin git@github.com:你的用户名/你的仓库名.git

二、如果本地已经有项目

直接跳到第 5 步，关联远程仓库：

# 1. 查看当前已关联的远程仓库
git remote -v

# 2. 如果没关联，就用上面的命令添加
git remote add origin https://github.com/你的用户名/你的仓库名.git

# 3. 首次推送并设置默认上游
git push -u origin main

---

三、两种创建方式对比

表格

方式	步骤	适用场景
先 GitHub 建库，再本地 init	上面完整流程	新项目、还没git仓库
直接克隆 GitHub 仓库	git clone https://github.com/xxx/xxx.git	空仓库 / 已有代码的仓库，一步到位

---

四、关键易错点提醒

1. 远程地址写错 / 重复：如果提示fatal: remote origin already exists，说明已经关联过远程，可以用下面的命令修改：

   # 先删除旧的远程关联
   git remote remove origin
   # 再重新添加正确的地址
   git remote add origin 新地址

2. 远程有初始 README，本地提交推不上去：

   # 拉取远程初始提交，合并到本地
   git pull origin main --allow-unrelated-histories
   # 解决冲突后再push
   git push origin main