Github远程托管本地文件教程

1、基础环境准备

• 拥有一个github帐号

• 本地可以访问github（必要时科学上网）

• 本地安装git环境

2、创建本地仓库

• 在本地仓库文件夹下打开终端“Git Bash Here”

• git config --global user.name "个人GitHub用户名"

• git config --global user.email "个人GitHub绑定邮箱"

• git init

• git add . # 将当前目录下所有文件添加到暂存区（注意不要忘记“.”）

• git commit -m "Initial commit" # 将暂存区内容提交到本地仓库，生成第一个提交

3、创建Github远程仓库

• 登录Github帐号

• 创建“New repository”，填写仓库名称，选择“Public”或"Private"

• 关键点： “Add a README” 或 “Initialize with .gitignore” 等选项，因为你已经有了一个现成的本地项目，直接初始化会引发冲突。

• 点击“Create repository”完成创建

4、创建SSH连接

• ssh-keygen -t ed25519 -C "your-email@example.com"，保存路径默认为“c:/Users/用户名/.ssh/id_ed25519”

• eval "$(ssh-agent -s)" 启动ssh-agent后台服务，应显示：Agent pid xxxx

• ssh-add ~/.ssh/id_ed25519 将私钥添加到代理

• cat ~/.ssh/id_ed25519.pub 显示公钥内容，鼠标选中复制

• 配置Github设置中的SSH and GPG keys，创建新的SSH Key，并将复制的公钥粘贴

• ssh -T git@github.com 测试连接，成功后会显示“Hi 你的用户名！ You've successfully auth...”

5、关联仓库并实现自动化推送

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

• git remote -v 检查现有远程地址，如果是HTTPS地址，使用下面命令改为SSH，否则不执行下一条命令

• git remote set-url origin git@github.com:用户名/仓库名.git

• git branch -M main # 强制重命名本地分支为main

• git push -u origin main # 将本地main分支推送到默认的远程仓库origin，并同步创建main分支

6、日常提交步骤

• cd 你的项目 # 使用Git终端执行命令

• git pull # 可选：先拉取远程最新代码，避免推送时冲突

• git status # 查看修改

• git add . # 添加所有更改

• git commit -m "添加了某某功能" # 提交到本地

• git push # 推送到 GitHub

注意：

1. 本地电脑磁盘和移动硬盘均可作为本地仓库空间！

2. GitHub单个文件大小（50MB）和仓库总容量（1GB）有限制！