技术文档

Git上传本地文件到GitHub指南

Git是一个强大的分布式版本控制系统，GitHub是一个基于Git的代码托管平台。本文将详细介绍如何使用Git将本地文件上传到GitHub仓库。

前提条件

在开始之前，请确保你已经：

  1. 安装了Git（可从Git官网下载安装）
  2. 在GitHub上注册了账号
  3. 已配置Git的用户信息：
1
2
3
4
5
# 配置用户名
git config --global user.name "你的GitHub用户名"

# 配置邮箱（与GitHub账号关联的邮箱）
git config --global user.email "你的邮箱地址"

方法一：从本地初始化Git仓库并关联GitHub

1. 在GitHub上创建新仓库

  1. 登录GitHub账号
  2. 点击右上角的+图标，选择New repository
  3. 填写仓库名称、描述等信息
  4. 不要勾选Initialize this repository with a README选项（因为我们要从本地上传）
  5. 点击Create repository

2. 在本地初始化Git仓库

  1. 打开命令行工具（Windows下为Git Bash、CMD或PowerShell）
  2. 进入要上传的项目文件夹：
1
cd 你的项目路径
  1. 初始化Git仓库：
1
git init
  1. 将项目文件添加到暂存区：
1
2
git add .
# 或者添加特定文件：git add 文件名
  1. 提交文件到本地仓库：
1
git commit -m "初始化项目提交"

3. 关联GitHub仓库并推送

  1. 复制GitHub仓库的HTTPS或SSH链接
  2. 添加远程仓库：
1
2
3
4
5
# HTTPS方式
git remote add origin https://github.com/你的用户名/仓库名.git

# 或SSH方式
git remote add origin git@github.com:你的用户名/仓库名.git
  1. 推送本地代码到GitHub：
1
2
git push -u origin main
# 注意：如果GitHub默认分支是master，则使用 git push -u origin master
  1. 如果是第一次使用HTTPS方式推送，需要输入GitHub的用户名和密码（或token）

方法二：克隆现有GitHub仓库并更新

如果已经有GitHub仓库，想更新内容，可以使用克隆方式：

  1. 克隆GitHub仓库到本地：
1
2
git clone https://github.com/你的用户名/仓库名.git
# 或使用SSH方式
  1. 进入克隆的文件夹：
1
cd 仓库名

  1. 修改或添加文件

  2. 将更改添加到暂存区：

1
git add .
  1. 提交更改：
1
git commit -m "更新内容描述"
  1. 推送到GitHub：
1
2
git push origin main
# 或 git push origin master

常见问题解决

1. 推送被拒绝（non-fast-forward）

当GitHub仓库有本地没有的更新时，会出现这个错误。解决方法：

1
2
3
4
5
# 先拉取远程仓库的最新代码
git pull origin main --rebase

# 然后再推送
git push origin main

2. SSH连接问题

如果使用SSH方式连接失败，需要检查SSH密钥配置：

1
2
3
4
5
6
7
8
9
# 检查是否有SSH密钥
ls -al ~/.ssh

# 生成新的SSH密钥（如果没有）
ssh-keygen -t ed25519 -C "你的邮箱"

# 添加SSH密钥到GitHub账户
cat ~/.ssh/id_ed25519.pub
# 复制输出的内容并添加到GitHub的SSH and GPG keys设置中

3. Gitignore文件

创建.gitignore文件可以忽略不需要上传的文件，例如：

1
2
3
4
5
6
7
8
9
# 忽略node_modules文件夹
node_modules/

# 忽略日志文件
*.log

# 忽略编辑器配置文件
.vscode/
.idea/