3. 代码管理-Git实战

文章目录

• 前言
• 一、提交已有工程
• • [1. ✅ 步骤 1：在 GitHub 上创建新仓库](#1. ✅ 步骤 1：在 GitHub 上创建新仓库)
  • [2. ✅ 步骤 2：在本地已有工程目录中初始化 Git（如果尚未初始化）](#2. ✅ 步骤 2：在本地已有工程目录中初始化 Git（如果尚未初始化）)
  • [3. ✅ 步骤 3：添加并提交所有文件](#3. ✅ 步骤 3：添加并提交所有文件)
  • [4. ✅ 步骤 4：关联远程 GitHub 仓库](#4. ✅ 步骤 4：关联远程 GitHub 仓库)
  • [5. ✅ 步骤 5：推送代码到 GitHub](#5. ✅ 步骤 5：推送代码到 GitHub)
  • [6. 🎉 完成！](#6. 🎉 完成！)

---

前言

Git实战‌

  。

---

一、提交已有工程

在 GitHub 上创建仓库后，将本地已有工程通过 Git 提交到该仓库

---

1. ✅ 步骤 1：在 GitHub 上创建新仓库

💡不初始化 README、.gitignore 或 LICENSE

1. 登录 GitHub
2. 点击右上角 + → New repository
3. 填写仓库名称（如 my-project）
4. 不要勾选 "Initialize this repository with a README"（否则会和本地历史冲突）
5. 点击 Create repository

你会看到类似这样的提示页面，包含 HTTPS 或 SSH 的远程地址，例如：

https://github.com/your-username/my-project.git

---

2. ✅ 步骤 2：在本地已有工程目录中初始化 Git（如果尚未初始化）

打开终端（或 Git Bash / PowerShell），进入你的项目根目录：

cd /path/to/your/local/project

如果项目还没有 Git 仓库，先初始化：

git init

---

3. ✅ 步骤 3：添加并提交所有文件

# 添加所有文件到暂存区
git add .

# 提交到本地仓库（写一个有意义的提交信息）
git commit -m "Initial commit"

💡 如果你之前已经用过 Git 并有提交历史，这一步可跳过，直接进行下一步。

---

4. ✅ 步骤 4：关联远程 GitHub 仓库

将本地仓库与 GitHub 远程仓库关联：

# 使用 HTTPS（推荐初学者）
git remote add origin https://github.com/your-username/my-project.git

# 或使用 SSH（如果你配置了 SSH 密钥）
git remote add origin git@github.com:your-username/my-project.git

🔍 可通过 git remote -v 查看是否设置成功。

---

5. ✅ 步骤 5：推送代码到 GitHub

# 推送到 main 分支（GitHub 默认分支名可能是 main 或 master）
git push -u origin main

⚠️ 如果你的本地默认分支是 master，而 GitHub 仓库默认是 main，会报错。

可以先重命名本地分支：

git branch -M main

然后再 git push -u origin main

---

6. 🎉 完成！

现在你的本地工程已成功推送到 GitHub 仓库。

---

🔁 补充：如果 GitHub 仓库已包含 README（不小心初始化了）会遇到 non-fast-forward 错误。

解决方法：

# 先拉取远程内容（带 --allow-unrelated-histories）
git pull origin main --allow-unrelated-histories

# 解决可能的合并冲突（比如保留本地或远程的 README）
# 然后提交合并
git add .
git commit -m "Merge remote README"

# 再推送
git push -u origin main

但最简单的方式是重新创建一个空仓库（不初始化任何文件），避免这个问题。

---

本文的引用仅限自我学习如有侵权，请联系作者删除。
参考知识
<>

---