在日常开发中，将本地项目上传到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管理项目，不仅能实现版本控制，还能方便团队协作和代码备份。如果在操作中遇到其他问题，欢迎在评论区留言讨论！