为什么你需要这份电脑GitHub上传教程?
每次修改完代码,你还在用U盘或网盘来回传输吗?团队协作时,版本混乱导致代码覆盖的情况是否让你头疼?GitHub作为全球最大的代码托管平台,能完美解决这些问题。但很多开发者,特别是初学者,在第一次使用GitHub上传代码时会遇到各种障碍——从Git配置错误到推送失败,每一步都可能成为拦路虎。
准备工作:安装和配置Git
1. 下载并安装Git
- 访问Git官网(https://git-scm.com/)下载对应操作系统的安装包
- Windows用户注意勾选"Add Git to PATH"选项
- 安装完成后,在终端输入git --version验证是否安装成功

2. 配置用户信息
- 打开终端或命令提示符
- 输入以下命令设置用户名和邮箱:
git config --global user.name "你的GitHub用户名" git config --global user.email "你的GitHub注册邮箱"
- 使用git config --list检查配置是否正确
创建和初始化本地仓库
你可能会问:为什么不能直接上传文件到GitHub?实际上,Git采用分布式版本控制,需要先在本地建立仓库。
1. 创建本地项目文件夹
- 在电脑上新建一个文件夹作为项目目录
- 建议使用英文命名,避免特殊字符和空格
2. 初始化Git仓库
- 打开终端,导航到项目文件夹(cd 文件夹路径)
- 运行git init命令初始化仓库
- 这时文件夹内会生成一个隐藏的.git目录
将代码上传到GitHub
1. 在GitHub上创建远程仓库
- 登录GitHub,点击右上角"+"选择"New repository"
- 填写仓库名称(通常与本地文件夹同名)
- 选择公开(Public)或私有(Private)
- 暂时不要勾选"Initialize this repository with a README"
2. 关联本地与远程仓库
- 复制GitHub仓库的HTTPS或SSH地址
- 在本地终端运行:
git remote add origin 你复制的仓库地址
- 使用git remote -v验证关联是否成功
3. 推送代码到GitHub
- 将项目文件添加到暂存区:git add .(注意最后的点)
- 提交更改:git commit -m "你的提交说明"
- 第一次推送使用:git push -u origin main
- 后续推送只需:git push
常见问题与解决方案
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 权限被拒绝(Publickey) | SSH密钥未配置 | 生成SSH密钥并添加到GitHub账户 |
| 无法推送非快进更新 | 本地与远程有冲突 | 先执行git pull合并更改 |
| 找不到.git目录 | 未正确初始化仓库 | 确保在项目目录运行git init |
有人会说:"用图形化工具不是更简单吗?"确实,GitHub Desktop等工具简化了操作,但理解命令行原理能让你更好地解决各种异常情况。当图形界面出现问题时,命令行往往能提供更多调试信息。
最后提醒:提交前检查.gitignore文件,避免上传临时文件或敏感信息。团队协作时,养成先pull再push的好习惯,可以节省大量解决冲突的时间。