为什么你需要这份GitHub上传指南？
第一次使用GitHub上传代码时，很多人会被git命令、SSH密钥、仓库权限等概念搞得晕头转向。明明本地运行正常的项目，上传到GitHub后不是显示不全就是报错。掌握正确的GitHub上传步骤不仅能避免这些尴尬，还能让你真正享受到版本控制的便利。下面我们就从最基础的操作开始，逐步拆解整个流程。
准备工作：创建GitHub仓库
在开始上传前，你需要先建立一个「容器」来存放代码，这就是GitHub仓库（Repository）。
网页端创建新仓库
- 登录GitHub账号，点击右上角「+」选择New repository
- 填写仓库名称（Repository name），建议使用英文且不含空格
- 选择公开（Public）或私有（Private）权限
- 勾选「Initialize this repository with a README」可自动生成说明文件
- 点击绿色「Create repository」按钮完成创建
本地准备上传文件
有人会问：「我能不能直接上传文件夹？」实际上需要先初始化本地git环境：
- 在项目根目录右键选择「Git Bash Here」
- 输入
git init初始化本地仓库 - 用
git add .添加所有文件到暂存区 - 执行
git commit -m "初次提交"完成本地提交
两种上传方法对比
| 方式 | 适用场景 | 难度 |
|---|---|---|
| 命令行 | 需要频繁更新的项目 | 较高 |
| 网页拖拽 | 单次上传少量文件 | 简单 |
方法一：命令行上传
这是开发者最常用的方式，虽然需要记住几个命令，但后续维护更方便：
- 关联远程仓库：
git remote add origin 你的仓库地址.git - 首次推送：
git push -u origin main（注意分支名称） - 后续更新只需要执行：
git push
方法二：网页端直接上传
适合不熟悉命令行的初学者：
- 进入你的GitHub仓库页面
- 点击「Add file」→「Upload files」
- 拖拽文件到指定区域或点击选择文件
- 填写提交说明（Commit message）后确认
常见问题解决方案
即使按照步骤操作，仍然可能遇到这些问题：
权限被拒绝（Permission denied）
这通常是因为没有正确配置SSH密钥：
- 检查是否生成了SSH密钥：
ls -al ~/.ssh - 如果没有，用
ssh-keygen -t ed25519 -C "你的邮箱"生成 - 将公钥内容添加到GitHub账户的SSH设置中
文件大小超出限制
GitHub对单个文件有100MB的限制：
- 对于大文件，建议使用Git LFS（Large File Storage）扩展
- 已经误传的大文件需要从提交历史中彻底清除
现在你应该能顺利完成GitHub上传了。记住，第一次操作可能会觉得步骤繁琐，但熟悉后整个过程不超过1分钟。遇到问题不妨多查阅GitHub官方文档，或者在你上传的项目里添加一个详细的README.md，这些都能让协作开发变得更顺畅。