Git 基础操作系列2: 本地项目上传至git仓库(gitee / gitlab / github)
一、核心步骤
若要把本地代码推送到Gitee上的新建远程分支，可按以下步骤操作：
1. 初始化本地仓库
首先要确保本地代码目录已初始化为Git仓库。在命令行中进入该目录，然后执行如下命令：
git init
2. 添加文件并提交
把本地代码添加到暂存区，接着提交到本地仓库。运行以下命令：
git add .
git commit -m "Initial commit"
3. 关联远程仓库
在Gitee上新建一个仓库，然后在本地仓库中关联该远程仓库。使用以下命令：
git remote add origin <Gitee仓库的SSH或HTTPS地址>
要把<Gitee仓库的SSH或HTTPS地址>替换成我们在Gitee上创建的仓库的实际地址。
4. 创建并切换到新分支
如果想把代码推送到一个新的远程分支，需先在本地创建并切换到该分支。执行以下命令：
git checkout -b <新分支名>
把<新分支名>替换成想要的分支名称。
5. 推送代码到远程新分支
最后，将本地代码推送到Gitee上的新分支。运行以下命令：
git push -u origin <新分支名>
此命令会把本地的<新分支名>推送到远程仓库，并设置该分支跟踪远程分支。
完整示例
假设在Gitee上新建了一个名为my-project的仓库，本地代码目录名为my-project-dir，想把代码推送到名为feature-branch的新分支，完整的命令如下：
cd my-project-dir
git init
git add .
git commit -m "Initial commit"
git remote add origin git@gitee.com:yourusername/my-project.git
git checkout -b feature-branch
git push -u origin feature-branch
把yourusername替换成我们的Gitee用户名。
按上述步骤操作，就能把本地代码推送到Gitee上的新建远程分支了。
二、遇到的问题
问题1：
$ git remote add origin git@gitee.com:dc/supplier/data-analysis.git
error: remote origin already exists.
Q1解决方案：
当看到 error: remote origin already exists. 这个错误信息时，意味着我们的本地仓库已经关联了一个名为 origin 的远程仓库。如果想要更新远程仓库的地址，或者只是想重新关联远程仓库，可以使用以下几种方法：
方法一：修改现有的远程仓库地址
如果想修改现有的 origin 远程仓库地址，可以使用 git remote set-url 命令。以下是具体操作：
git remote set-url origin git@gitee.com:dc/supplier/data-analysis.git
上述命令将 origin 远程仓库的地址更新为我们指定的新地址。
方法二：删除现有的远程仓库并重新添加
如果想要彻底删除现有的 origin 远程仓库，然后重新添加，可以按以下步骤操作：
# 删除现有的 origin 远程仓库
git remote remove origin
# 重新添加远程仓库
git remote add origin git@gitee.com:dc/supplier/data-analysis.git
方法三：使用其他名称添加远程仓库
如果我们不想覆盖现有的 origin 远程仓库，也可以使用其他名称来添加远程仓库，例如 gitee：
git remote add gitee git@gitee.com:dc/supplier/data-analysis.git
之后，当推送代码时，需要使用新的远程仓库名称，例如：
git push -u gitee <分支名>
可以根据自己的需求选择合适的方法来解决问题。
问题2：
$ git push -u origin f_hotfix_indexerror_20250507
git@gitee.com: Permission denied (publickey).
fatal: Could not read from remote repository.Please make sure you have the correct access rights
and the repository exists.
Q2解决方案：
当遇到 git@gitee.com: Permission denied (publickey). 错误时，这通常表示我们在使用 SSH 协议连接到 Gitee 仓库时，由于公钥验证失败而无法获得访问权限。可以按照以下步骤来解决这个问题：
1. 检查 SSH 密钥是否存在
首先，需要检查本地是否已经生成了 SSH 密钥。在终端中执行以下命令：
ls -al ~/.ssh
如果输出中包含 id_rsa.pub 或 id_ed25519.pub 等文件，说明我们已经生成了 SSH 密钥。如果没有这些文件，需要生成新的 SSH 密钥。
2. 生成新的 SSH 密钥（如果需要）
如果没有 SSH 密钥或者想要生成新的密钥，可以执行以下命令：
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
在执行过程中，可以按照提示设置密钥的保存路径和密码。
3. 将 SSH 公钥添加到 Gitee
- 复制公钥内容：使用以下命令复制公钥内容：
cat ~/.ssh/id_rsa.pub
- 登录 Gitee：打开 Gitee 网站并登录我们的账户。
- 添加 SSH 公钥：进入个人设置页面，选择“SSH 公钥”，将复制的公钥内容粘贴到相应的输入框中，并设置一个公钥标题，然后点击“确定”。
4. 测试 SSH 连接
添加公钥后，我们可以使用以下命令测试 SSH 连接：
ssh -T git@gitee.com
如果看到类似以下的输出，说明连接成功：
Hi username! You've successfully authenticated, but Gitee does not provide shell access.
5. 再次尝试推送代码
完成上述步骤后，再次尝试推送代码：
git push -u origin f_hotfix_indexerror_20250507
通过以上步骤，应该能够解决 SSH 公钥验证失败的问题，并成功推送代码到 Gitee 仓库。