如何将代码上传到 Gitee？Git 使用指南

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

cd /path/to/your/project

2. 初始化 Git 仓库：

git init

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

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

4. 将文件添加到暂存区：

git add .

5. 提交到本地仓库：

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

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

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

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

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

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

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

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

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

git remote -v

3. 推送代码到 Gitee：

git push -u origin main

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

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

2.4 第四步：验证上传结果

1. 刷新 Gitee 仓库页面：你应该能看到你的项目代码和提交记录。
2. 恭喜，你的项目成功上传到了 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'，导致远程仓库已有提交记录与本地冲突。解决方法：

1. 拉取远程代码并合并：

git pull origin main --allow-unrelated-histories

2. 解决冲突后，再推送：

git push -u origin main

4.2 如何忽略某些文件？

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

node_modules/
*.log
.env
.DS_Store

五、总结

掌握 Git 和 Gitee 的基本操作，能大大提高开发效率和代码管理能力。无论是个人项目还是团队合作，版本控制和代码托管都是不可或缺的工具。

按照本文的步骤，你就能轻松将项目上传到 Gitee，也能更好地理解 Git 与 Gitee/GitHub 的关系。