如何将代码轻松上传到 Gitee？Git 使用全攻略！

裴竹悦 · 3 天前

在开发过程中，代码托管平台是每个开发者的必备工具。无论你是刚接触版本控制的新手，还是已经拥有多项目管理经验的程序员，掌握如何将代码上传到 Gitee 或 GitHub 都是必不可少的技能。
今天，我将带你一步步了解 如何将项目上传到 Gitee，并且在过程中顺便深入解析 Git、Gitee 和 GitHub 的关系，让你在使用这些工具时不再迷茫。

一、准备工作：Git 基础知识

首先，我们需要知道 Git 是什么，它是如何与 Gitee 和 GitHub 配合使用的。
1.1 什么是 Git？

Git 是一款开源的分布式版本控制工具，旨在帮助程序员管理代码历史、团队协作以及代码合并。无论你是一个人开发项目，还是和团队一起协作，Git 都能帮助你：

跟踪代码的更改
回退到任何历史版本
合并团队成员的修改

1.2 Git 与 Gitee 和 GitHub 的关系

Git：本地管理代码的版本控制工具。
Gitee：由国内码云公司推出的 Git 托管平台，类似 GitHub，但主打国内用户，提供了国内更快的访问速度，并支持私有仓库。
GitHub：全球知名的 Git 托管平台，适用于开源项目，许多大公司和开发者都将项目托管在 GitHub 上，广受开发者欢迎。

简单来说，Git 是工具，Gitee 和 GitHub 是平台，Git 负责本地管理，Gitee/GitHub 用来托管代码，方便多人协作和在线访问。

二、如何将代码上传到 Gitee

上传代码到 Gitee 主要分为以下三个步骤：创建仓库、初始化 Git、关联并推送代码。下面是详细的操作步骤：
2.1 第一步：在 Gitee 网站上创建远程仓库

登录/注册 Gitee 账号：首先，访问 gitee.com 并登录或注册一个账号。
新建仓库：
- 点击页面右上角的 + 号，选择 “新建仓库”。
- 填写仓库信息：
  - 仓库名称：例如 my-project。
  - 仓库路径：通常自动生成，可根据需要修改。
  - 简介：可选，简要描述仓库内容。
  - 公开性：
    - 公开：任何人都能访问，适合开源项目。
    - 私有：只有特定用户可以访问，适合私密项目。
  - 初始化选项：建议不要勾选 “添加 .gitignore”、“许可证” 或 “README”，因为如果本地已有代码，勾选这些会生成额外文件，导致推送时冲突。
创建仓库并复制仓库地址：
- 点击 “创建” 后，仓库页面会显示远程仓库的 URL。
- 复制该地址。常见格式如下：
  - HTTPS 格式：https://gitee.com/你的用户名/你的仓库名.git
  - SSH 格式：git@gitee.com:你的用户名/你的仓库名.git（需要配置 SSH 密钥，新手建议使用 HTTPS 格式）。

2.2 第二步：在本地电脑准备项目

在本地进行初始化操作：
情况 A：全新项目（未使用 Git 管理）

进入项目文件夹：在终端或命令行中，进入你本地的项目目录：

cd /path/to/your/project

复制代码

初始化 Git 仓库：

git init

复制代码

配置 Git 用户信息（如果是第一次使用 Git）：

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

复制代码

将文件添加到暂存区：

git add .

复制代码

提交到本地仓库：

git commit -m "first commit: 初始化项目"

复制代码

情况 B：已有本地 Git 管理项目

如果你的项目已经用 Git 进行管理，只需跳过 git init 步骤，直接进入关联远程仓库步骤。

2.3 第三步：关联远程仓库并上传代码

添加远程仓库地址：在本地项目文件夹中，执行以下命令，将本地仓库与 Gitee 仓库进行关联：

git remote add origin https://gitee.com/你的用户名/你的仓库名.git

复制代码

如果提示 fatal: remote origin already exists，你可以通过以下命令修改远程仓库地址：

git remote set-url origin https://gitee.com/你的用户名/你的仓库名.git

复制代码

验证远程仓库关联是否成功：

git remote -v

复制代码

推送代码到 Gitee：

git push -u origin main

复制代码

注意：main 是新版 Git 默认的主分支名，旧版 Git 默认是 master，如果你的分支名称是 master，需要将命令中的 main 换成 master。

输入 Gitee 账号密码：
- 如果你使用 HTTPS 地址，会提示输入 Gitee 用户名和密码。为了安全性，建议使用 个人访问令牌 代替密码。
- 如果使用 SSH 地址，确保你已经配置了 SSH 密钥，若没有配置，可以选择使用 HTTPS。

2.4 第四步：验证上传结果

刷新 Gitee 仓库页面：你应该能看到你的项目代码和提交记录。
恭喜，你的项目成功上传到了 Gitee！

三、Git 与 Gitee、GitHub 的关系

Git 是一个开源的版本控制工具，而 Gitee 和 GitHub 是两个托管 Git 仓库的服务平台。它们的关系可以用以下几点来总结：
3.1 Git 是工具，Gitee 和 GitHub 是平台

Git：用于本地管理代码版本。
Gitee：国内代码托管平台，提供更快的访问速度，适合中国用户，支持私有仓库，适用于公司或个人隐私项目。
GitHub：国际上最受欢迎的代码托管平台，开源项目众多，拥有广泛的社区支持，适合全球开发者。

3.2 Gitee 和 GitHub 的异同

相同点：
- 都是 Git 仓库托管平台。
- 都支持公开和私有仓库。
- 都支持项目管理、团队协作和自动化功能。
不同点：
- Gitee：主打国内市场，访问速度快，支持更多的国内开发者习惯。
- GitHub：全球最大代码托管平台，广泛支持开源项目，拥有庞大的开发者社区。

四、常见问题与解决方案

4.1 推送失败：failed to push some refs

通常是因为在 Gitee 创建仓库时勾选了“初始化 README”，导致远程仓库已有提交记录与本地冲突。解决方法：

拉取远程代码并合并：

git pull origin main --allow-unrelated-histories

复制代码

解决冲突后，再推送：

git push -u origin main

复制代码

4.2 如何忽略某些文件？

在项目根目录创建 .gitignore 文件，写入你希望 Git 忽略的文件或文件夹。例如：

node_modules/
*.log
.env
.DS_Store

复制代码

五、总结

掌握 Git 和 Gitee 的基本操作，能大大提高开发效率和代码管理能力。无论是个人项目还是团队合作，版本控制和代码托管都是不可或缺的工具。
按照本文的步骤，你就能轻松将项目上传到 Gitee，也能更好地理解 Git 与 Gitee/GitHub 的关系。如果你遇到任何问题，随时欢迎提问！

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！

账号		自动登录	找回密码
密码			立即注册

如何将代码轻松上传到 Gitee？Git 使用全攻略！

相关帖子

浏览过的版块

签约作者

如何将代码轻松上传到 Gitee？Git 使用全攻略！

相关帖子

相关推荐

浏览过的版块

签约作者