第一步：下载并安装 Git

你需要先在操作系统中安装 Git 的底层程序。

• Windows 用户： 访问 Git 官网（git-scm.com）下载 Windows 版本的安装包。

  安装提示：一路点击 Next（下一步） 即可。在选择默认编辑器时，如果看到了 Visual Studio Code，可以选择它，找不到也没关系，直接默认下一步就行。

• Mac 用户： 打开终端（Terminal），输入 git --version 并回车。如果系统没安装，会自动弹出一个提示框，问你是否要安装“命令行开发者工具”，点击安装即可。

安装完成后，你可以重启一下 VS Code。

---

第二步：在电脑上配置你的“身份”

Git 要求每次提交代码都必须署名，这样团队协作时才知道是谁改的代码。

你只需要打开电脑的终端（Windows 的命令提示符/PowerShell，或者 Mac 的终端），运行以下两行命令（把名字和邮箱换成你自己的）：

git config --global user.name "你的英文名字"
git config --global user.email "你的邮箱@example.com"

---

检查 VS Code 是否成功识别

完成上面两步后，打开 VS Code：

1. 按下快捷键 Ctrl + Shift + G（Mac 上是 Cmd + Shift + G）打开源代码管理面板。
2. 如果它没有再提示你“未找到 Git”之类的警告，而是显示了“初始化仓库”或者“发布到 GitHub”的按钮，说明 VS Code 已经完美找到了你电脑里的 Git！

现在，你就可以愉快地在 VS Code 里面用鼠标点点点来管理代码了。

vscode terminal 打开方式是ctrl ~

---

Git 远程仓库配置与多平台同步指南

在开发过程中，我们经常需要将本地现有的代码推送到远程 Git 仓库（如 GitLab、GitHub 或私有 Git 服务器）。本文将梳理如何干净地初始化一个远程仓库，以及如何配置 Git 允许一条命令同时推送到两个不同的远程平台。

---

功能一：全新远程仓库的“避坑”初始化与推送

如果你本地已经有了代码文件夹（例如 My_Toolkits），在 Git 平台（GitLab/GitHub）上创建新仓库时，有一个最核心的原则：不要勾选任何初始化选项。

1. 创建仓库时的配置建议

选项	建议操作	原因
Project name	填你的文件夹名	建议与本地文件夹名保持一致，方便管理。
Visibility Level	Private 或 Public	根据项目的隐私需求决定。
Initialize with README	不勾选 (Unchecked)	最重要！ 保持远程仓库完全空白，否则本地代码首次推送会因历史不一致而冲突。
Enable Static Analysis	不勾选	减少不必要的 CI/CD 干扰，除非你明确需要。

💡 为什么不能勾选 Initialize with README？ 如果勾选了，远程服务器会先生成一个初始提交。当你尝试 git push 本地代码时，Git 会报错提示 “远程仓库包含你本地没有的工作”。此时你必须执行 git pull --allow-unrelated-histories 强行合并，或者用 git push -f 强行覆盖，会带来不必要的麻烦。

2. 首次推送的基本命令

确保远程仓库完全空白后，在本地终端执行以下命令进行关联和推送：

# 1. 关联远程仓库地址
git remote add origin http://<your-git-server-ip>:<port>/your-group/your-repo.git

# 2. 查看当前本地分支名称（通常是 main 或 master）
git branch

# 3. 推送并建立分支关联（以 main 为例）
git push -u origin main

---

功能二：配置 Git 同时推送到两个远程仓库

有时候我们需要实现代码备份或多平台同步（例如：同时推送到内网私有 Git 服务器和外网托管平台 GitLab/GitHub）。我们可以利用 Git 的 --add --push 机制，实现一条命令，双向同步。

第一步：清理并重新构建远程链

为了确保路径干净，我们先清除旧的关联，然后重新绑定。请在本地项目根目录下按顺序执行以下命令：

# 1. 删除现有的 origin 关联（别担心，这不会删掉你的本地代码）
git remote remove origin

# 2. 重新添加内部私有服务器地址，作为主抓取 (Fetch) 和默认推送 (Push) 地址
git remote add origin http://<your-private-ip>:<port>/your-group/your-repo.git

# 3. 顺便追加外网平台的 SSH 推送地址（实现双发）
git remote set-url --add --push origin git@<public-gitlab-or-github>.com:<username>/your-repo.git

# 4. 把内部私有服务器地址也明确追加到 push 列表中
git remote set-url --add --push origin http://<your-private-ip>:<port>/your-group/your-repo.git

第二步：验证配置

配置完成后，运行以下命令检查远程仓库状态：

git remote -v

如果配置成功，你应该会看到类似下面的输出。注意：Fetch 只有一个，而 Push 会有两个不同的地址：

origin  http://<your-private-ip>:<port>/your-group/your-repo.git (fetch)
origin  git@<public-gitlab-or-github>.com:<username>/your-repo.git (push)
origin  http://<your-private-ip>:<port>/your-group/your-repo.git (push)

第三步：正式推送

现在，你只需要像平时一样执行推送命令。Git 会自动遍历 push 列表，将代码同时打包发送到这两个服务器：

# 如果你的主分支叫 main
git push -u origin main

# 如果你的主分支叫 master
git push -u origin master

---

附录：首次使用 SSH 密钥推送时的常见误区

当首次通过 SSH 地址（如 git@gitlab.com:...）推送代码 medical 时，终端通常会弹出如下提示：

The authenticity of host 'gitlab.com (...)' can't be established.
ED25519 key fingerprint is: SHA256:...
Are you sure you want to continue connecting (yes/no/[fingerprint])?

直接输入 yes 并回车即可，Git 会把该主机加入本地的信任列表 (~/.ssh/known_hosts)。

如何查看本地公钥？

如果系统提示没有权限（Permission denied），说明你需要把本地公钥配置到 Git 平台的账号设置中。

在本地终端运行以下命令查看公钥（注意：绝对不能把私钥给别人，我们要的是带有 .pub 后缀的公钥）：

# 优先查看现代高效的 ED25519 格式公钥
cat ~/.ssh/id_ed25519.pub

# 如果上面提示文件不存在，查看传统 RSA 格式的公钥
cat ~/.ssh/id_rsa.pub

复制输出的整行文本（通常以 ssh-ed25519 或 ssh-rsa 开头），粘贴到你 Git 账号的 SSH Keys 设置中即可。