前言
在日常开发中，将本地代码推送到 GitHub 远程仓库是必备技能，本文整理了从本地仓库初始化到远程推送的完整流程，以及过程中常见报错的解决方法，用于记录博主的学习经验，供大家参考。
目录
[1. 创建本地版本库](#1. 创建本地版本库)
[2. 将源代码纳入本地仓库](#2. 将源代码纳入本地仓库)
[3. 配置 SSH 加密传输（关键）](#3. 配置 SSH 加密传输（关键）)
[4. 关联远程仓库并推送代码](#4. 关联远程仓库并推送代码)
论文投稿：
第六届人工智能与工业技术应用国际学术会议（AIITA 2026）
大会时间：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 使用本地代理：
bashgit config --global http.proxy http://127.0.0.1:7890 -
验证代理是否设置成功：
bashgit 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）。