Git 四种仓库连接方式操作指南

本文将梳理 HTTPS、HTTPS+Token、SSH 公钥、SSH 私钥迁移 四种常用连接方式,结合 Windows 环境的操作细节,形成一套可直接复用的完整流程

基础前置配置

打开 Git Bash,全局配置账号邮箱,仅首次设置

bash 复制代码
git config --global user.name "你的用户名"
git config --global user.email "你的注册邮箱"
# 查看配置
git config --global --list

方式一:HTTPS 账号密码连接

适用场景

快速克隆 / 推送、无密钥配置环境、临时协作

操作步骤

进入项目文件夹,初始化本地仓库

bash 复制代码
# 创建并进入测试仓库文件夹
mkdir gitdemo
cd gitdemo
# 初始化本地Git仓库
git init

关联远程仓库

bash 复制代码
# 通用HTTPS地址格式
git remote add origin https://gitee.com/用户名/gitdemo.git
# 查看远程关联状态
git remote -v

本地初次提交并推送

bash 复制代码
# 创建初始文件
touch README.md
# 暂存文件
git add .
# 本地提交
git commit -m "首次初始化提交"
# 推送至远程,弹窗输入账号密码验证
git push -u origin master

方式二:HTTPS+Token 令牌连接

适用场景

平台限制密码登录、规避密码过期、长期 HTTPS 免密使用

操作步骤

  1. 平台个人设置页,进入安全设置,生成个人访问令牌,仅勾选仓库读写权限,复制令牌密钥

  2. 拼接带 Token 的仓库地址 通用格式: https://用户名:生成的Token@gitee.com/用户名/gitdemo.git

  3. 替换仓库远程地址

bash 复制代码
git remote set-url origin 拼接后的完整地址
git remote -v

常规推拉代码

bash 复制代码
git pull
git add .
git commit -m "功能修改提交"
git push

优劣总结

全程免密不受登录策略限制;令牌涉密,不可随意外泄


方式三:SSH 公钥连接

适用场景

日常主力开发、频繁提交、团队协作长期使用

环境说明

Windows 优先使用 Git Bash 操作,CMD 命令提示符无catls指令,无法查看密钥文件

操作步骤

生成 SSH 密钥对

bash 复制代码
# ed25519安全密钥算法,尾部为密钥备注
ssh-keygen -t ed25519 -C "Gitee SSH Key"

执行后连续三次回车,默认存储路径、不设置密钥密码

控制台输出示例:

查看密钥文件,读取公钥

bash 复制代码
# 查看生成的公私钥文件
ls ~/.ssh/
# 读取公钥内容
cat ~/.ssh/id_ed25519.pub

复制ssh-ed25519开头的全部公钥文本

  1. 平台绑定公钥 个人设置 - SSH 公钥页面,粘贴复制内容,保存生效

  2. 测试 SSH 连通性

bash 复制代码
ssh -T git@gitee.com

提示认证成功即为配置完成

切换仓库 SSH 地址

bash 复制代码
git remote set-url origin git@gitee.com:用户名/gitdemo.git
git remote -v

免密日常操作

复制代码
git pull
git add .
git commit -m "SSH模式提交代码"
git push

优劣总结

安全性高、永久免密稳定;初次需要手动生成绑定密钥


方式四:SSH 私钥迁移配置

适用场景

多设备切换开发、已有密钥迁移复用、本地密钥损坏恢复

操作步骤

  1. 将已有可用私钥id_ed25519,放入本机~/.ssh目录下

  2. Linux/Mac 系统修复文件权限,Windows 可跳过

bash 复制代码
chmod 600 ~/.ssh/id_ed25519

挂载私钥至本地 SSH 代理

bash 复制代码
eval `ssh-agent -s`
ssh-add ~/.ssh/id_ed25519

验证连接并关联仓库

bash 复制代码
ssh -T git@gitee.com
git remote set-url origin git@gitee.com:用户名/gitdemo.git

优劣总结

密钥快速复用,省去重复配置;私钥高度保密,严禁外传


四种连接方式对比表

连接方式 免密使用 配置难度 安全等级 适用场景
HTTPS 账号密码 极低 一般 临时单次操作
HTTPS+Token 中等 账号密码受限场景
SSH 公钥 中等 日常主力开发
SSH 私钥迁移 偏高 多设备密钥迁移

通用远程地址切换命令

bash 复制代码
# 查看当前仓库连接地址
git remote -v
# 替换为对应协议仓库地址
git remote set-url origin 新仓库地址

  1. 示例仓库名为gitdemo,实际使用替换为自身项目名即可
  2. 仓库默认分支分为master/main,根据仓库实际分支名调整命令
  3. 内网代理环境 SSH 大概率无法连通,优先选用 HTTPS+Token 方式
  4. 多平台账号可创建多组密钥,区分绑定使用避免冲突
相关推荐
Patrick_Wilson7 小时前
为什么gitlab的MR会默认有一个merge commit
前端·git·gitlab
是乐乐啊呀7 小时前
版本控制 GIT 和 SVN
git·svn
夜鸣笙笙10 小时前
Git详细安装流程
git
瑞码空间1 天前
git知识点黄金笔记
笔记·git·elasticsearch
----云烟----1 天前
Git 提交忽略某些文件方法
git
切糕师学AI1 天前
如何查看已合并到 master 分支的所有分支?Git 分支清理指南
大数据·git·elasticsearch
DevUp1 天前
一个管「引」,一个管「抄」:Submodule 和 Subtree 到底差在哪
git·前端工程化
lingran__1 天前
Git 完全指南(三):远程仓库与标签管理
开发语言·git·gitee·ssh·团队协作·远程仓库·分布式版本控制
lingran__2 天前
Git 完全指南(二):分支管理
git·分支管理·版本控制·团队协作·多人开发·git flow
必须会一定会2 天前
Agent Handoff v0.6.0 跨电脑同步:Git、EVENTS.jsonl、CONTEXT.md 使用方法
人工智能·git·ai编程