将本地代码推送到 GitHub 的完整指南

下面是将本地代码推送到 GitHub 的详细步骤，包括初次推送和后续更新的流程。

准备工作

安装 Git
- 下载地址：https://git-scm.com/downloads
- 安装后配置用户信息：

1
git config --global user.name "你的用户名"
2
git config --global user.email "你的邮箱"

创建 GitHub 账户
- 访问 https://github.com 注册账户
生成 SSH 密钥（推荐）

1
ssh-keygen -t ed25519 -C "你的邮箱"
2
# 将公钥(~/.ssh/id_ed25519.pub)添加到 GitHub SSH keys

方法一：从零开始推送新项目

步骤 1：在 GitHub 创建新仓库

+ 登录 GitHub + 点击右上角 "+" → "New repository" + 输入仓库名称，选择公开/私有，**不要**初始化 README

步骤 2：初始化本地仓库

```bash # 进入项目目录 cd your-project-directory

初始化 Git 仓库#

git init

添加所有文件到暂存区#

git add .

提交更改#

git commit -m “Initial commit”

1
<h3 id="yIGtv">步骤 3：连接远程仓库并推送</h3>
2
```bash
3
# 添加远程仓库（替换为你的仓库URL）
4
git remote add origin https://github.com/你的用户名/仓库名.git
5

6
# 首次推送
7
git push -u origin main
8
# 如果使用 master 分支，则改为：
9
# git push -u origin master

方法二：推送现有本地仓库

如果你已经有一个本地 Git 仓库：

1
# 添加远程仓库
2
git remote add origin https://github.com/你的用户名/仓库名.git
3

4
# 重命名分支（如果需要）
5
git branch -M main
6

7
# 推送代码
8
git push -u origin main

方法三：使用 SSH（更安全）

```bash # 添加 SSH 远程仓库 git remote add origin git@github.com:你的用户名/仓库名.git

推送代码#

git push -u origin main

1
<h2 id="HGu31">日常更新工作流程</h2>
2
<h3 id="f6U0J">基本流程</h3>
3
```bash
4
# 1. 查看当前状态
5
git status
6

7
# 2. 添加更改的文件
8
git add .  # 添加所有更改
9
# 或
10
git add 文件名  # 添加特定文件
11

12
# 3. 提交更改
13
git commit -m "描述这次提交的内容"
14

15
# 4. 推送到远程仓库
16
git push

从远程拉取更新

```bash # 拉取远程更改并合并 git pull

或分别执行#

git fetch git merge

1
<h2 id="qOBAn">常见问题解决</h2>
2
<h3 id="QIOoU">1. 首次推送冲突</h3>
3
```bash
4
# 如果远程有 README 等文件
5
git pull origin main --allow-unrelated-histories
6
git push

2. 认证失败

+ 使用 Personal Access Token 替代密码 + 或配置 SSH 密钥

3. 分支名称问题

```bash # 查看当前分支 git branch

重命名分支#

git branch -M 新分支名

1
<h2 id="U2uAK">实用命令参考</h2>
2
```bash
3
# 查看远程仓库
4
git remote -v
5

6
# 查看提交历史
7
git log --oneline
8

9
# 撤销本地更改
10
git checkout -- 文件名
11

12
# 撤销暂存的文件
13
git reset HEAD 文件名

最佳实践

1. **提交信息**：写清晰的提交说明 2. **频繁提交**：小步提交，便于追踪 3. **分支策略**：使用功能分支开发 4. **忽略文件**：创建 `.gitignore` 文件排除不需要版本控制的文件

示例 .gitignore：

1
# 依赖目录
2
node_modules/
3
vendor/
4

5
# 日志文件
6
*.log
7

8
# 环境变量文件
9
.env
10
.env.local
11

12
# 系统文件
13
.DS_Store
14
Thumbs.db

按照这些步骤，你就能成功将本地代码推送到 GitHub 并建立有效的版本控制工作流。