目录
[1. 初始化现有项目](#1. 初始化现有项目)
[2. 在GitHub创建对应仓库](#2. 在GitHub创建对应仓库)
[1. 创建本地仓库](#1. 创建本地仓库)
[2. 在GitHub创建远程仓库](#2. 在GitHub创建远程仓库)
[3. 链接本地与远程仓库](#3. 链接本地与远程仓库)
[1. 在GitHub创建仓库](#1. 在GitHub创建仓库)
[2. 克隆到本地](#2. 克隆到本地)
[1. 测试远程连接](#1. 测试远程连接)
[2. 查看分支信息](#2. 查看分支信息)
本地仓库与远程仓库链接
场景一：链接现有本地项目
1. 初始化现有项目
如果我们本地有个项目但是没有链接到远程仓库是会报错的，所以我们在创建好git个人账户之后要去链接上我们远程的仓库
bash
cd existing-project # 到本地工作目录下
# 进行git初始化，初始化一个新的仓库；执行 git init 后，会在当前目录创建 .git 文件夹
git init
bash
git add . # 添加文件到暂存区
git commit -m "Initial commit of existing project" # 提交第一个版本
# 添加远程仓库
git remote add origin git@github.com:你的用户名/existing-project.git2. 在GitHub创建对应仓库
-
同样方式创建新仓库
-
名称与本地项目名一致
-
不初始化README
场景二：从零开始新项目
1. 创建本地仓库
bash
# 创建项目目录
mkdir my-project
cd my-project
# 初始化Git仓库
git init
# 创建基础文件
echo "# My Project" > README.md
echo "print('Hello World')" > main.py
# 首次提交
git add .
git commit -m "Initial commit: project setup"2. 在GitHub创建远程仓库
登录 GitHub
点击右上角 "+" → "New repository"
仓库名称：my-project（与本地目录名一致）
描述：可选填写项目描述
权限：Public（公开）或 Private（私有）
不要 勾选 "Initialize this repository with a README"，易导致首次push冲突
点击 "Create repository"
3. 链接本地与远程仓库
bash
# 添加远程仓库（SSH方式推荐）
git remote add origin git@github.com:你的用户名/my-project.git
# 或者使用HTTPS方式（需要输入密码）
git remote add origin https://github.com/你的用户名/my-project.git
# 验证远程仓库配置
git remote -v
# 应该显示：
# origin git@github.com:你的用户名/my-project.git (fetch)
# origin git@github.com:你的用户名/my-project.git (push)场景三：克隆远程仓库到本地
1. 在GitHub创建仓库
-
创建新仓库
-
这次可以勾选 "Add a README file"
-
可以选择添加 .gitignore 和 license
2. 克隆到本地
bash
# SSH方式（推荐）
git clone git@github.com:你的用户名/repo-name.git
# HTTPS方式
git clone https://github.com/你的用户名/repo-name.git
# 克隆到指定目录
git clone git@github.com:你的用户名/repo-name.git my-local-folder第四部分：验证链接配置
1. 测试远程连接
bash
# 验证远程仓库配置
git remote -v
# 测试SSH连接
ssh -T git@github.com
# 如果成功会显示：Hi 用户名! You've successfully authenticated...
# 获取远程信息
git remote show origin2. 查看分支信息
bash
# 查看本地分支
git branch
# 查看所有分支（包括远程）
git branch -a
# 获取远程分支信息
git fetch --all第五部分：多远程仓库配置
同时链接多个远程仓库
bash
# 添加个人仓库作为origin
git remote add origin git@github.com:你的用户名/project.git
# 添加另一个远程仓库（如备份仓库）
git remote add backup git@github.com:你的用户名/project-backup.git
# 查看所有远程仓库
git remote -v
# 输出：
# origin git@github.com:你的用户名/project.git (fetch)
# origin git@github.com:你的用户名/project.git (push)
# backup git@github.com:你的用户名/project-backup.git (fetch)
# backup git@github.com:你的用户名/project-backup.git (push)在完成步骤之后你就可以进行代码提交了
常见问题解决
bash
# 1. 如果输错了远程地址
git remote remove origin
git remote add origin 正确的地址
# 2. 修改已存在的远程地址
git remote set-url origin git@github.com:你的用户名/project.git
# 3. 检查网络连接
ping github.com
# 4. 检查SSH密钥权限
chmod 600 ~/.ssh/id_ed25519
chmod 644 ~/.ssh/id_ed25519.pub
# 5. 测试特定远程仓库的连接
git ls-remote origin