跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
编程语言

Git 本地仓库关联 Gitee 远程仓库教程

如何将本地 Git 仓库与 Gitee 远程仓库进行关联配置。内容包括安装 Git 和注册账号、初始化本地仓库、创建远程仓库、关联远程地址、推送代码以及处理常见冲突问题。此外还讲解了 SSH 免密配置和 .gitignore 文件的使用,帮助用户实现代码的云端存储和版本管理。

二进制发布于 2026/3/28更新于 2026/9/1164 浏览
Git 本地仓库关联 Gitee 远程仓库教程

准备工作

在开始之前,请确保你已经完成了以下两步:

  1. 安装 Git:从 git-scm.com 下载适合你操作系统的版本,并安装。安装时全部选默认选项即可。
  2. 注册 Gitee 账号:访问 gitee.com 注册一个账号。注册完成后登录。
第一步:在本地创建或进入你的项目文件夹

打开你的电脑,找到你想要上传到 Gitee 的项目文件夹。如果还没有项目,可以新建一个测试文件夹,比如在桌面新建一个名为 my-project 的文件夹。

第二步:在文件夹中初始化 Git 仓库
  1. 进入该文件夹。在文件夹空白处右键,选择 Git Bash Here(Windows 系统)或者打开终端(Mac/Linux)并 cd 到该文件夹。

在弹出的命令行窗口中输入以下命令,然后按回车:

git init

这条命令会在当前文件夹中创建一个隐藏的 .git 文件夹,表示 Git 仓库初始化成功。你会看到类似 Initialized empty Git repository in ... 的提示。

第三步:将你的项目文件添加到 Git 暂存区

假设你的文件夹里已经有了项目文件(比如 index.html、app.js 等)。如果没有,可以先创建一个测试文件,比如新建一个 README.md 文件。

输入以下命令,将所有文件添加到暂存区:

git add .

注意命令最后有一个点 .,代表当前文件夹下的所有文件。如果你只想添加某个文件,可以用 git add 文件名。

随后提交到本地仓库,并附上提交说明:

git commit -m "第一次提交"

双引号里的内容可以换成你想要的说明,比如'初始化项目'。

第四步:在 Gitee 上创建一个远程仓库
  1. 登录 Gitee 网站,点击右上角的 + 号,选择 新建仓库。
  2. 填写仓库信息:
    • 仓库名称:给你的仓库起个名字,比如 my-project(建议和本地文件夹同名)。
    • 路径:会自动生成,一般不用改。
    • 仓库介绍:可选,简单描述项目。
    • 是否开源:根据自己的需要选择,私有仓库只有你能看到(部分功能可能需要付费)。
    • 初始化仓库:不要勾选任何初始化选项(如'使用 Readme 文件初始化'),因为我们本地已经有文件了,避免产生冲突。
  3. 点击 创建 按钮。

创建成功后,你会跳转到仓库主页,页面中间会显示远程仓库的地址。复制这个地址,有两种格式:

  • HTTPS:https://gitee.com/你的用户名/my-project.git
  • SSH:[email protected]:你的用户名/my-project.git

如果你是第一次使用,建议先用 HTTPS,比较简单。

第五步:将本地仓库与远程仓库关联

回到刚才的 Git Bash 或终端窗口,输入以下命令(将地址替换成你复制的 HTTPS 地址):

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

这条命令的意思是:添加一个名为 origin 的远程仓库,地址是后面的 URL。origin 是远程仓库的默认名字,你可以改成别的,但通常都用 origin。

第六步:将本地代码推送到远程仓库

输入以下命令,将本地 master 分支的内容推送到远程 origin 仓库:

git push -u origin master

如果是第一次推送,可能会弹出登录窗口,要求输入 Gitee 的用户名和密码(如果是 HTTPS 方式)。输入你在 Gitee 注册的邮箱/手机号和密码即可。

如果一切顺利,你会看到类似下面的输出:

Counting objects: 3, done. Writing objects: 100% (3/3), 215 bytes |215.00 KiB/s, done. Total 0(delta 0), reused 0(delta 0)
remote: Powered by Gitee.com
To https://gitee.com/你的用户名/my-project.git
 * [new branch]      master -> master
Branch 'master' set up to track remote branch 'master' from 'origin'.

现在刷新你的 Gitee 仓库页面,就能看到刚才推送的文件了!


常见问题及解决方法

1. 推送时提示"failed to push some refs"

这通常是因为远程仓库已经有了文件(比如你创建仓库时勾选了'初始化仓库'),而本地没有这些文件,导致冲突。

解决方法:先拉取远程仓库的内容合并到本地,再推送。

git pull origin master --allow-unrelated-histories

这条命令会拉取远程内容,并允许合并不相关的历史。之后再次执行 git push -u origin master 即可。

2. 输入密码时提示"Username for 'https://gitee.com'

如果你在推送时被要求反复输入用户名密码,可以配置 Git 记住密码:

git config --global credential.helper store

执行后第一次推送仍需输入,之后 Git 会记住密码,不再提示。

3. 想要使用 SSH 方式推送(免密且更安全)

如果你希望以后推送不用每次都输密码,可以配置 SSH 密钥:

  • 在 Git Bash 中生成密钥:ssh-keygen -t rsa -C "你的邮箱",一路回车。
  • 找到生成的公钥(默认在 C:\Users\你的用户名\.ssh\id_rsa.pub),用记事本打开并复制全部内容。
  • 登录 Gitee,点击头像 -> 设置 -> SSH 公钥,把复制的内容粘贴进去,标题随便填。
  • 然后在本地仓库执行:git remote set-url origin [email protected]:你的用户名/my-project.git 将远程地址改为 SSH 格式。

之后推送就不再需要密码了。


进阶操作:添加 .gitignore 文件

正常添加并提交的流程,这里就不再叙述,主要讲一下,git 先提交了不想要追踪的文件,然后才添加 .gitignore 文件的场景,如果不想要跟踪这些文件,如何去处理呢?

  1. 打开终端 / Git Bash 进入你的项目根目录(也就是包含 .git 文件夹的那个目录)。

  2. 确认 .gitignore 已正确配置 检查一下 .gitignore 文件是否包含了这三行(每行一个):

.obsidian/
.trash/
.DS_Store
  1. 从 Git 缓存中删除这些文件/目录 执行以下命令,将它们从版本控制中移除(本地文件会原封不动保留),如果目标文件不在根目录,则需要使用 cd 命令进入对应的子目录执行 git rm -r --cached 目标文件:
git rm -r --cached .obsidian
git rm -r --cached .trash
git rm --cached .DS_Store

*注意:目录后面加斜杠 / 更明确,但不加也可以。

  1. 提交这次变更 现在 Git 会检测到这些文件/目录被'删除'(实际上是移除追踪),你需要提交这个变化:
git add .
git commit -m "停止追踪 .obsidian .trash .DS_Store"
  1. 推送到远程仓库 最后,将这次提交推送到 Gitee:
git push
验证效果
  • 执行完上述步骤后,远程仓库(Gitee)上的这三个目录/文件就会被删除。
  • 以后你本地对这些文件的任何修改,都不会再被 Git 检测到变更,也不会被同步工具自动同步。
  • 如果你希望其他协作者的本地仓库也同步这个'不再追踪'的状态,他们只需要执行 git pull 拉取这次提交即可(但要注意,他们本地原有的 .obsidian 等文件不会被删除,只是之后不再被追踪)。

目录

  1. 准备工作
  2. 第一步:在本地创建或进入你的项目文件夹
  3. 第二步:在文件夹中初始化 Git 仓库
  4. 第三步:将你的项目文件添加到 Git 暂存区
  5. 第四步:在 Gitee 上创建一个远程仓库
  6. 第五步:将本地仓库与远程仓库关联
  7. 第六步:将本地代码推送到远程仓库
  8. 常见问题及解决方法
  9. 1. 推送时提示"failed to push some refs"
  10. 2. 输入密码时提示"Username for 'https://gitee.com'
  11. 3. 想要使用 SSH 方式推送(免密且更安全)
  12. 进阶操作:添加 .gitignore 文件
  13. 验证效果

更多推荐文章

查看全部
  • OpenClaw 钉钉群聊多机器人配置实战
  • OpenClaw 与 Telegram 机器人集成指南
  • AI Agent 辅助工具:Superpowers 框架使用与原理分析
  • AI 赋能软件测试流程
  • SQL Server 2022 安装与配置实战指南
  • PDFShuffler:开源免费的 PDF 文档整理工具
  • 32 款国产 Claw 系 AI 工具收录与官网汇总
  • 3DGS 算法架构与实现:初始化、密度控制与训练策略
  • 基于 Xilinx UltraScale+ FPGA 的 100G UDP 协议栈设计与实现
  • 基于 Word2Vec 与 RAG 的个人知识库构建指南
  • MySQL 基本查询与增删改查实战指南
  • 2025 机构开发栈:14 款 Web 模板与技术选型深度评测
  • Claude Code 安装与使用指南
  • WebPShop 插件:Photoshop 处理 WebP 格式的完整指南
  • Codex 跨平台安装与登录指南(Windows/macOS/Linux)
  • 华为设备 SSH 远程登录配置实战
  • ComfyUI 深度解析:高性能 AI 绘画工作流实践
  • MonkeyCode:重新定义 AI 编程协作流程
  • Python pip 常用命令:版本查看、安装与卸载
  • 清华大学与智谱团队探索 RLHF 的 Scaling Laws

相关免费在线工具

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online

  • JSON美化和格式化

    将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online