第四章：连接远程仓库（GitHub / Gitee）

← 上一章：第一个 Git 仓库 | 返回目录 | 下一章：分支入门 →

到目前为止，你的代码只保存在本地电脑上。这一章我们来把它推送到远程平台，实现云端备份和协作。

以下以 Gitee 为例演示，GitHub 操作几乎一样。

4.1 在 Gitee 上创建远程仓库

1. 登录 https://gitee.com
2. 点击右上角的 ”+” 号，选择 “新建仓库”
3. 填写信息：
   • 仓库名称：my-first-project（和本地项目名一致就好）
   • 描述：可选，比如”我的第一个 Git 项目”
   • 公开/私有：选”公开”或”私有”都行
   • 其他选项全部不勾选（不要勾选”初始化仓库”，因为我们本地已经有了）
4. 点击 “创建”

创建成功后，页面会显示一个仓库地址，类似：

https://gitee.com/你的用户名/my-first-project.git

复制这个地址，下一步要用。

GitHub 的操作类似：登录后点击右上角 ”+“，选 “New repository”，填写仓库名，不要勾选 “Add a README file”，然后点 “Create repository”。

4.2 本地仓库关联远程仓库

回到你的终端（确保在项目目录下），输入：

git remote add origin https://gitee.com/你的用户名/my-first-project.git

origin 是远程仓库的别名（约定俗成用 origin），后面是你刚才复制的地址。

检查是否关联成功：

git remote -v

输出：

origin  https://gitee.com/你的用户名/my-first-project.git (fetch)
origin  https://gitee.com/你的用户名/my-first-project.git (push)

4.3 推送代码到远程

首次推送：

git push -u origin main

系统会提示你输入 Gitee/GitHub 的用户名和密码（或 Token）。输入后代码就推送到远程了。

-u 参数会建立本地分支和远程分支的关联，只需要在第一次推送时加上。

如果遇到分支名问题：

有些 Git 版本默认分支名是 master 而不是 main，你可以用 git branch 查看当前分支名，然后把命令中的 main 替换成对应的名称。

或者统一设置默认分支名为 main：

git config --global init.defaultBranch main

后续推送（已经关联过了）：

以后每次提交后，只需要简单地：

git push

4.4 从远程拉取代码

git pull —— 获取远程最新代码

当远程仓库有更新时（比如队友推送了新代码），用：

git pull

它会自动下载远程的最新改动并合并到你的本地。

git clone —— 克隆已有仓库

如果你想把别人的（或者自己在另一台电脑上的）项目下载到本地：

git clone https://gitee.com/用户名/仓库名.git

这个命令会在当前目录下创建一个新文件夹，里面就是完整的项目。

clone 和 init 的区别：

4.5 动手练习

# 1. 在 Gitee/GitHub 上创建一个空仓库（参照 4.1）

# 2. 进入之前的练习项目
cd git-practice

# 3. 关联远程仓库（替换成你自己的地址）
git remote add origin https://gitee.com/你的用户名/git-practice.git

# 4. 推送到远程
git push -u origin main

# 5. 打开 Gitee/GitHub 网页，刷新仓库页面，你应该能看到你的代码了！

# 6. 在另一个位置 clone 下来体验
cd ..
git clone https://gitee.com/你的用户名/git-practice.git git-practice-copy
cd git-practice-copy
git log --oneline

如果能看到你之前的提交记录，说明你已经完全打通了 “本地 ↔ 远程” 的链路！

← 上一章：第一个 Git 仓库 | 返回目录 | 下一章：分支入门 →