GitHub远程代码仓库上传代码：完整指南

GitHub 是全球最大的代码托管平台，学会如何上传代码至 GitHub 是开发者必备技能。本文将详细介绍如何从本地 Git 仓库推送代码到 GitHub，涵盖基础操作、常见问题及最佳实践。

1. 准备工作

(1) 安装 Git

确保你的电脑已安装 Git（官网下载）：

git --version # 检查是否安装成功

(2) 注册 GitHub 账号

访问 GitHub 并注册账号。

配置 SSH Key（可选但推荐）：ssh-keygen -t ed25519 -C "your_email@example.com" # 生成 SSH 密钥

cat ~/.ssh/id_ed25519.pub # 复制公钥，添加到 GitHub Settings → SSH Keys

(3) 创建 GitHub 仓库

点击 GitHub 首页右上角 "New repository"。

填写仓库名称（如 my-project），选择 Public/Private。

初始化选项（可留空，后续手动推送代码）。

2. 上传本地代码到 GitHub

方法1：本地已有项目，首次推送

# 进入项目目录

cd my-project

# 初始化 Git 仓库

git init

# 添加文件到暂存区

git add .

# 提交更改

git commit -m "Initial commit"

# 关联远程仓库（替换为你的 GitHub 仓库地址）

git remote add origin git@github.com:your-username/my-project.git

# 推送代码（-u 设置默认远程分支）

git push -u origin main

方法2：克隆远程仓库，修改后推送

# 克隆仓库到本地

git clone git@github.com:your-username/my-project.git

# 修改代码后提交

git add .

git commit -m "Update feature"

# 推送更改

git push

3. 常见问题 & 解决方案

Q1: git push 失败，提示 "Permission denied"

原因：未正确配置 SSH 或 HTTPS 权限。

解决：

如果使用 HTTPS，运行：git remote set-url origin https://github.com/your-username/my-project.git

git push

如果使用 SSH，确保 ~/.ssh/id_ed25519.pub 已添加到 GitHub。

Q2: 推送时提示 "non-fast-forward" 错误

原因：远程仓库有更新，本地未同步。

解决：

git pull --rebase # 拉取远程更新并变基

git push # 再次推送

Q3: 误删文件或提交，如何恢复？

恢复单个文件：git checkout HEAD -- filename

回退到某个 commit：git reset --hard commit-id # 慎用！会丢失之后的更改

git push -f # 强制推送（仅限个人仓库）

4. 最佳实践

✅ 分支策略：

main 分支存放稳定代码。

新功能在 feature/xxx 分支开发，通过 Pull Request 合并。

✅ Commit 规范：

使用 Conventional Commits 格式，如：git commit -m "feat: add user login"

git commit -m "fix: resolve login bug"

✅ .gitignore 文件：

忽略无需上传的文件（如 node_modules/, .env）。

示例：# 忽略日志文件

*.log

# 忽略依赖目录

node_modules/

5. 总结

从本地 Git 仓库上传代码到 GitHub 的完整流程，包括：

GitHub 仓库创建

本地代码推送（git init → git add → git commit → git push）

常见问题解决（权限冲突、代码恢复等）

最佳实践（分支管理、Commit 规范）