Git 远程连接仓库学习笔记（本地→GitHub）

前言

在日常开发中，将本地代码推送到 GitHub 远程仓库是必备技能，本文整理了从本地仓库初始化到远程推送的完整流程，以及过程中常见报错的解决方法，用于记录博主的学习经验，供大家参考。

前言

一、核心操作流程

[1. 创建本地版本库](#1. 创建本地版本库)

[2. 将源代码纳入本地仓库](#2. 将源代码纳入本地仓库)

（1）查看文件状态

（2）添加文件到暂存区

（3）提交到本地仓库

[3. 配置 SSH 加密传输（关键）](#3. 配置 SSH 加密传输（关键）)

[4. 关联远程仓库并推送代码](#4. 关联远程仓库并推送代码)

论文投稿：
第六届人工智能与工业技术应用国际学术会议（AIITA 2026）

大会官网：https://ais.cn/u/eYfaam

大会时间：2026年04月10-12日

大会地点：中国 · 重庆 · 帕格森蒂两江蒂苑酒店

一、核心操作流程

1. 创建本地版本库

首先在本地新建一个文件夹作为代码仓库，打开终端（或 Git Bash）进入该文件夹，执行初始化命令：

bash 复制代码

git init

执行后文件夹中会生成隐藏的.git目录，标志本地 Git 仓库创建完成。

2. 将源代码纳入本地仓库

初始化后，把需要管理的代码文件放入该文件夹，通过以下命令完成本地提交：

（1）查看文件状态

bash 复制代码

git status

红字：文件未添加到 Git 暂存区，处于未追踪状态；
绿字：文件已添加到暂存区，等待提交到本地仓库。

（2）添加文件到暂存区

bash 复制代码

# 添加指定文件夹下的所有文件
git add 文件夹名/
# 添加当前目录下的所有文件（最常用）
git add .

（3）提交到本地仓库

bash 复制代码

git commit -m "注释内容"

-m后紧跟本次提交的说明（必填），比如git commit -m "初始化项目，添加核心代码"，便于后续追溯版本。

3. 配置 SSH 加密传输（关键）

本地 Git 仓库与 GitHub 之间的传输默认通过 SSH 加密，需先配置 SSH Key，避免每次推送都输入账号密码：

配置步骤可参考：https://blog.csdn.net/qq_29493173/article/details/113094143

4. 关联远程仓库并推送代码

（1）新建远程仓库

在 GitHub 上创建一个空仓库（注意：若仓库非空，需先拉取远程内容，否则推送会冲突）。

（2）关联本地与远程仓库

bash 复制代码

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

比如：git remote add origin https://github.com/xu-xiaoya/Elegent.git

（3）推送代码到远程仓库

bash 复制代码

# 首次推送（远程仓库为空时，加-u参数，关联本地master分支与远程master分支）
git push -u origin master
# 后续推送（仓库非空，无需-u）
git push origin master

二、常见报错及解决方法

报错信息

bash 复制代码

fatal: unable to access 'https://github.com/.../.git': Recv failure Connection was reset

解决方法

方法一：取消代理设置（优先尝试）

bash 复制代码

git config --global --unset http.proxy 
git config --global --unset https.proxy

方法二：设置系统代理（代理环境下）

确认代理服务器端口（比如 7890）；

配置 Git 使用本地代理：

bash 复制代码

git config --global http.proxy http://127.0.0.1:7890

验证代理是否设置成功：
bash 复制代码
```
git config --global -l
```
若输出中包含http.proxy=http://127.0.0.1:7890，说明配置生效。

三、完整步骤梳理

本地建文件夹，执行git init初始化仓库；
放入代码文件，执行git add .添加到暂存区；
执行git commit -m "注释"提交到本地仓库；
GitHub 配置 SSH 密钥，新建远程仓库；
执行git remote add origin 远程仓库地址关联仓库；
执行git push -u origin master（首次）/git push origin master（后续）推送代码。

总结

Git 本地仓库核心操作：git init初始化 → git add .添加 → git commit提交，三步完成本地版本管理；
远程推送关键：配置 SSH 密钥避免重复验证，首次推送加-u关联分支，非首次直接git push origin master；
连接报错优先取消代理，代理环境下需配置 Git 代理端口（如 7890）。