如何将代码轻松上传到 Gitee？Git 使用全攻略！
在开发过程中，代码托管平台是每个开发者的必备工具。无论你是刚接触版本控制的新手，还是已经拥有多项目管理经验的程序员，掌握如何将代码上传到 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 格式：
[email protected]:你的用户名/你的仓库名.git（需要配置 SSH 密钥，新手建议使用 HTTPS 格式）。
- 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 的关系。如果你遇到任何问题，随时欢迎提问！
