怎么用SSH从git init 把本地任务推送到GitCode上?

将本地项目通过 SSH 推送到 GitCode 上,整个过程可以分为以下几个清晰的步骤。请按照顺序操作:

整体流程概览

  1. 本地初始化 Git 仓库 (git init)

  2. 配置 Git 用户信息 (首次使用需要)

  3. 在 GitCode 上创建新项目

  4. 生成并添加 SSH 密钥 (实现免密推送的关键)

  5. 将本地仓库与远程仓库关联

  6. 推送代码到 GitCode


详细步骤

第 1 步:在本地项目目录初始化 Git

打开终端(命令行),进入你的项目根目录。

cd /path/to/your/project
git init

这会在当前目录创建一个新的 .git 文件夹。

第 2 步:配置全局用户信息(如果之前没配置过)

这步很重要,你的提交记录会附带这些信息。

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

注意:这里的“用户名”和“邮箱”最好与你在 GitCode 上注册的账户一致。

第 3 步:在 GitCode 上创建新项目
  1. 登录你的 GitCode 账户。

  2. 点击页面右上角的 “+” 号或 “新建项目” 按钮。

  3. 填写项目名称、描述等信息。

  4. 非常重要:在“初始化仓库”部分,不要勾选 “使用 README 文件初始化仓库”、“添加 .gitignore” 或 “添加许可证”。

    • 原因:因为我们已经在本地初始化了仓库,如果远程仓库也初始化,会导致历史不一致,需要先合并,对新手不友好。我们推送的是一个完全空的仓库。

创建完成后,你会看到一个空项目的页面。

第 4 步:配置 SSH 密钥(这是实现 SSH 连接的核心)
a) 检查是否已存在 SSH 密钥

在终端输入:

ls -al ~/.ssh

查看是否有名为 id_rsa.pub 或 id_ed25519.pub 的文件。如果存在,可以跳过生成密钥的步骤。

b) 生成新的 SSH 密钥对

使用你的 GitCode 注册邮箱替换下面的命令:

ssh-keygen -t ed25519 -C "[email protected]"
  • 如果系统不支持 ed25519,可以使用:ssh-keygen -t rsa -b 4096 -C "[email protected]"

  • 按回车后,它会询问保存密钥的文件路径,直接按回车使用默认位置即可。

  • 接着会提示你输入一个密码(passphrase),可以留空(直接回车),也可以设置一个以提高安全性。

c) 将 SSH 公钥添加到 GitCode
  1. 复制公钥内容

    # 对于 macOS
    cat ~/.ssh/id_ed25519.pub | pbcopy
    # 对于 Linux (如果安装了 xclip)
    cat ~/.ssh/id_ed25519.pub | xclip -sel clip
    # 或者直接查看然后手动复制
    cat ~/.ssh/id_ed25519.pub

    你会看到一串以 ssh-ed25519 (或 ssh-rsa)开头,你的邮箱结尾的文本,全部复制它。

  2. 在 GitCode 中添加公钥

    • 点击 GitCode 网站右上角你的头像,进入 “设置”

    • 在左侧菜单栏中选择 “SSH 公钥”

    • 将刚才复制的公钥内容粘贴到 “公钥” 文本框中。

    • 给它起一个可识别的标题(例如:My Laptop)。

    • 点击 “添加”

d) 测试 SSH 连接

在终端输入:

ssh -T [email protected]

第一次连接时,你会看到类似如下的警告:

The authenticity of host 'gitcode.net (IP_ADDRESS)' can't be established.
ED25519 key fingerprint is SHA256:xxxxxxxx...
Are you sure you want to continue connecting (yes/no/[fingerprint])?

输入 yes 并按回车。

如果一切正常,你会看到一条欢迎信息,如:

Welcome to GitCode, YourUsername!

这表明你的 SSH 密钥配置成功了。

第 5 步:关联本地仓库与 GitCode 远程仓库

回到你的本地项目目录。

  1. 添加所有文件到暂存区

    git add .
    # 或者添加特定文件 git add README.md ...
  2. 进行第一次提交

    git commit -m "Initial commit"
  3. 添加远程仓库地址
    在 GitCode 你的项目主页,找到“克隆”按钮,确保选择的是 “SSH” 选项。你会看到一个类似这样的地址:
    [email protected]:your_username/your_project_name.git

    在终端中执行以下命令(请将地址替换为你自己的):

    git remote add origin [email protected]:your_username/your_project_name.git

    这里的 origin 是远程仓库的一个别名,可以自定义,但通常都用 origin

第 6 步:推送代码到 GitCode

现在,将本地的 main (或 master) 分支推送到远程的 origin

# 如果你本地是 main 分支
git branch -M main
git push -u origin main
  • -M 是 --move --force 的缩写,用于重命名当前分支为 main

  • -u (或 --set-upstream) 选项会将本地的 main 分支与远程的 main 分支关联起来。下次你只需要简单地输入 git push 即可。

如果 GitCode 创建项目时默认分支是 master,则使用:

git push -u origin master

完成!

刷新你的 GitCode 项目页面,你应该能看到所有代码文件都已经成功推送到了平台上。

总结一下关键点:

  • SSH 密钥 是免密推送的通行证,务必正确生成和配置。

  • 创建远程仓库时,不要初始化,以避免冲突。

  • 添加远程地址时,确认使用的是 SSH URL,而不是 HTTPS。

以后在这个项目里进行开发,只需要常规的三步曲即可:

git add .
git commit -m "你的提交信息"
git push

posted @ 2026-02-05 11:57  gccbuaa  阅读(5)  评论(0)    收藏  举报