如何使用Git工具将项目代码上传至代码托管平台

目前主流的代码托管平台

1. GitHub：github.com
2. Gitee：开源软件 - Gitee.com
3. GitCode：GitCode - 全球开发者的开源社区,开源代码托管平台

---

整体流程概览

1. 准备工作：安装 Git 并创建代码托管平台账号。

2. 创建本地 Git 仓库：在您的项目文件夹中初始化 Git。

3. 连接远程仓库：将您的本地仓库与代码托管平台上创建的仓库关联起来。

4. 提交文件：将文件添加到暂存区并提交。

5. 推送文件：将本地提交推送到代码托管平台远程仓库。

---

详细步骤

第一步：准备工作

1. 安装 Git

   • 如果您还没有安装 Git，请访问 https://git-scm.com/ 下载并安装。

   • 安装后，打开终端（Linux/macOS）或 Git Bash（Windows），设置您的用户名和邮箱，这将用于记录您的提交。

   git config --global user.name "您的用户名"
   git config --global user.email "您的邮箱@example.com"

2. 注册 GitCode 账号并创建仓库

   • 访问 https://gitcode.net/ 注册或登录您的账号。

   • 点击页面右上角的 “+” 号或 “新建仓库” 按钮。

   • 填写仓库名称、描述（可选），选择公开或私有。

   • 非常重要：如果您是第一次使用，建议不要勾选 “使用 README 文件初始化仓库”、“添加 .gitignore” 或 “选择许可证”。这会创建一个空的仓库，便于我们从头开始演示。点击“创建”按钮。

第二步：初始化本地仓库

1. 打开终端或 Git Bash，导航到您的项目文件夹。

   cd /path/to/your/project

2. 初始化 Git 仓库。

   git init

   这个命令会在当前目录创建一个名为 .git 的子目录，Git 的所有仓库数据都存放在这里。

第三步：连接远程仓库

1. 在 GitCode 上创建好空仓库后，你会看到一个快速设置页面，其中包含仓库的 HTTPS 或 SSH 地址。复制这个地址。

   • HTTPS: https://gitcode.net/your_username/your_repo_name.git

   • SSH: git@gitcode.net:your_username/your_repo_name.git

   HTTPS vs. SSH 如何选择？

   • HTTPS：简单，无需配置，但每次推送可能需要输入用户名和个人访问令牌（GitCode 已禁用密码验证）。

   • SSH：需要一些初始配置（生成 SSH 密钥并添加到 GitCode），但配置成功后，后续操作无需再输入凭证。推荐使用此方式。

2. 将远程仓库地址添加到您的本地仓库。我们通常给这个远程仓库起名叫 origin。

   # 使用 HTTPS
   git remote add origin https://gitcode.net/your_username/your_repo_name.git
   
   # 或者使用 SSH（推荐）
   git remote add origin git@gitcode.net:your_username/your_repo_name.git

   您可以使用 git remote -v 命令来检查是否添加成功。

第四步：提交文件

1. 添加文件到暂存区：使用 git add 命令将文件添加到 Git 的暂存区，这是提交前的准备区域。

   • 添加所有文件（包括隐藏文件）：

   git add .

   • 添加特定文件：

   git add filename1.txt filename2.js

2. 提交更改：使用 git commit 命令将暂存区的内容正式提交到本地仓库。-m 后面是本次提交的说明，请务必填写清晰易懂的描述。

   git commit -m "首次提交：初始化项目，包含项目基础结构和核心功能"

第五步：推送到 GitCode

现在，您本地的提交已经准备好了，需要将它们“推送”到远程的 GitCode 仓库。

使用 git push 命令，并指定远程仓库名（origin）和分支名（main 或 master）。

• 如果你的默认分支是 main（新仓库的默认设置）：

  git push -u origin main

• 如果你的默认分支是 master（一些旧系统的默认设置）：

  git push -u origin master

参数解释：

• -u：这是 --set-upstream 的简写。它会在推送的同时，将本地的 main 分支与远程的 origin/main 分支关联起来。这样，下次您在这个分支上直接使用 git push 或 git pull 时，Git 就知道应该操作哪个远程分支了。

如果是 HTTPS 方式，此时会弹出一个窗口，要求您输入用户名和密码。请注意，密码部分您需要输入在 GitCode 上设置的“个人访问令牌”，而不是您的登录密码。

---

后续操作

首次设置完成后，您日常的工作流程将简化为：

1. 修改您的项目文件。

2. git add . （添加更改）

3. git commit -m "您的提交信息" （提交更改）

4. git push （推送到远程仓库，因为之前用了 -u，现在不需要再指定参数了）

---

常见问题（FAQ）

Q1：git push 时提示 error: failed to push some refs to ...

A： 这通常是因为 GitCode 上的远程仓库有您本地没有的提交（例如，您在创建仓库时勾选了初始化 README 文件）。解决方法：先执行 git pull origin main --allow-unrelated-histories 将远程内容拉取到本地合并，然后再执行 git push。

Q2：如何设置 SSH 密钥？

A：

1. 在本地生成 SSH 密钥对：ssh-keygen -t ed25519 -C "your_email@example.com"（一路回车即可）。

2. 查看公钥内容：cat ~/.ssh/id_ed25519.pub，并复制全部内容。

3. 登录 GitCode，进入 设置 -> SSH 公钥，将复制的内容粘贴到“公钥”框中，设置一个标题，然后点击“添加”。

Q3：如何上传到一个已存在的非空仓库？

A： 如果远程仓库已经有文件（比如初始化了 README），你需要先拉取（pull）并合并（merge）远程的更改，然后再推送。

git pull origin main --allow-unrelated-histories
# 解决可能出现的合并冲突
git push -u origin main