【超详细】从0到1教你将本地方案上传到GitHub及常见问题应对

在日常开发中，将本地项目上传到GitHub进行版本管理和备份是开发者的必备技能。本文将详细介绍完整的上传流程，并针对上传过程中可能遇到的SSL证书错误等问题提供解决方案，适合Git新手参考。

一、准备工作：环境配置

在开始上传项目前，需要完成以下基础配置：

GitHub账号注册
访问GitHub官网，注册并登录你的账号（已有账号可忽略此步）。
安装Git工具
下载并安装适合你操作系统的Git客户端：
- 官方下载地址：https://git-scm.com/downloads
  安装完成后，打开终端（Windows用户推荐使用Git Bash），配置用户信息：
```
# 替换为你的GitHub用户名
git config --global user.name "你的用户名"
# 替换为你的GitHub注册邮箱
git config --global user.email "你的邮箱地址"
```

二、完整上传步骤：从本地到GitHub

步骤1：在GitHub创建远程仓库

登录GitHub后，点击右上角「+」图标，选择「New repository」；
填写仓库信息：
- 仓库名称（建议与本地项目名一致）；
- 选择仓库可见性（Public公开/ Private私有）；
- 可选：勾选「Add a README file」（初始化仓库说明文件）；
点击「Create repository」，创建完成后会显示仓库地址（如https://github.com/你的用户名/仓库名.git），复制该地址备用。

步骤2：本地项目初始化与提交

进入你的本地项目根目录，执行以下命令：

# 进入项目目录（替换为你的实际路径）
cd /path/to/your/你的项目文件名
# 初始化本地Git仓库（仅首次执行）
git init
# 将所有文件添加到暂存区
# 注意：如需忽略不必要的文件（如build目录、日志文件），可创建.gitignore文件
git add .
# 提交文件到本地仓库（填写有意义的提交说明）
git commit -m "简要描述此次提交项目内容"

步骤3：关联远程仓库并推送

关联远程仓库
使用步骤1中复制的仓库地址，执行以下命令：

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

推送本地代码到GitHub
```
# 首次推送需指定分支（默认主分支为main）
git push -u origin main
```
- 若提示「branch ‘main’ does not exist」，需先创建主分支：
```
git branch -M main
```
- 推送时可能需要验证身份：GitHub已不再支持密码验证，需使用个人访问令牌（PAT）：
  生成PAT的方法：GitHub账号 → Settings → Developer settings → Personal access tokens → Generate new token（勾选repo权限）。

步骤4：后续更新推送

当本地项目有修改后，只需执行以下三步即可更新到GitHub：

# 1. 添加修改的文件到暂存区
git add .
# 2. 提交修改（说明本次更新内容）
git commit -m "修复xxx问题/新增xxx功能"
# 3. 推送到远程仓库
git push

三、常见问题解决1：无法访问，无法连接服务

在执行git push或git pull时，可能会遇到如下错误：
fatal: unable to access 'https://github.com/xxx/xxx.git/': Failed to connect to 127.0.0.1 port 7890 after 2050 ms: Could not connect to server

解决方案：自己搜索CFW（该软件我无法提供下载链接，因为会被屏蔽掉）并下载软件，运行该app即可解决问题

四、常见问题解决2：SSL证书验证失败

在执行git push或git pull时，可能也会遇到如下错误：
fatal: unable to access 'https://github.com/xxx/xxx.git/': SSL certificate problem: unable to get local issuer fatal: unable to access 'https://github.com/xxx/xxx.git/': Failed to connect to 127.0.0.1 port 7890 after 2050 ms: Could not connect to server certificate

这是由于本地Git无法验证GitHub的SSL证书导致的，解决方案如下：

方案1：临时跳过SSL验证（快速测试）

适用于紧急推送场景，关闭当前终端的SSL验证（重启终端后失效）：

# 关闭全局SSL验证
git config --global http.sslVerify false
# 再次尝试推送
git push -u origin main

方案2：永久解决（更新根证书，推荐）

临时关闭验证存在安全风险，建议通过更新证书彻底解决：

Windows系统：

下载最新根证书：https://curl.se/ca/cacert.pem；
保存到Git安装目录的证书文件夹（如C:\Program Files\Git\mingw64\ssl\certs\cacert.pem，需匹配实际安装路径）；

配置Git使用该证书：

git config --global http.sslCAInfo "C:\Program Files\Git\mingw64\ssl\certs\cacert.pem"

macOS系统：

通过Homebrew更新OpenSSL（需先安装Homebrew）：
```
brew install openssl
```

配置证书路径：

git config --global http.sslCAInfo /usr/local/etc/openssl/cert.pem

Linux系统（以Ubuntu为例）：

更新系统根证书库：

sudo apt-get update && sudo apt-get install ca-certificates

重启终端后即可正常使用。

方案3：检查并修正仓库地址

若仓库地址格式错误（如末尾多了斜杠），也可能导致证书验证失败：

# 查看当前远程仓库地址
git remote -v
# 若地址错误（如带斜杠），执行以下命令修正
git remote set-url origin https://github.com/你的用户名/你的仓库名.git

五、总结

本文详细介绍了从环境配置到项目上传GitHub的完整流程，并针对常见的SSL证书错误提供了多种解决方案。核心步骤可总结为：
「配置Git → 创建远程仓库 → 本地初始化 → 关联并推送」

通过GitHub管理项目，不仅能实现版本控制，还能方便团队协作和代码备份。如果在操作中遇到其他问题，欢迎在评论区留言讨论！

posted on 2025-12-16 13:13 ljbguanli 阅读(1023) 评论(0) 收藏举报