1.2 获得仓库

---

🚀 两种获取仓库的方式

要开始使用 Git 进行项目版本控制，您有两种核心方法。请根据您的需求选择合适的方式：

初始化 (git init) 在您现有的本地项目目录中，开启 Git 版本控制。

克隆 (git clone) 从远程仓库（如 GitHub）完整复制一个现有项目到本地。

---

方式一：在现有目录中初始化仓库

当您想对一个全新的或已有的本地项目开始进行版本控制时，使用此方法。

1. 导航与初始化

进入您的项目根目录，并执行初始化命令。这会在目录中创建核心的 .git 隐藏文件夹。

# 1. 导航到项目目录
cd /path/to/your/amazing/project

# 2. 初始化 Git 仓库
git init

2. 添加并提交首次更改

使用 git add 命令将文件添加到暂存区，然后使用 git commit 命令提交更改。

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

# 提交更改，并添加提交信息
git commit -m "Initial commit"

方式二：克隆一个现有仓库

当您想获取一个已在远程托管（如 GitHub、GitLab 或 Bitbucket）的项目副本时，使用 git clone 命令。这是参与协作或获取开源项目的标准方法。

1. 选择克隆协议

远程仓库地址通常有两种形式：HTTPS 和 SSH。请选择适合您环境和权限的方式。

HTTPS (推荐)

适用于大多数用户，特别是如果您使用个人访问令牌 (Token) 或用户名/密码进行身份验证。

git clone https://github.com/user/repo-name.git

💡 提示

如果您的 Git 客户端配置了凭证管理器，HTTPS 方式可以记住您的身份信息，避免每次操作都输入密码。

SSH (专业用户)

如果您设置了 SSH 密钥对，这是无需每次输入密码的最便捷方式，特别适合频繁贡献者。

git clone git@github.com:user/repo-name.git

⚠️ 先决条件

使用 SSH 协议前，您必须已经在您的 GitHub/GitLab 账户中配置了您的 SSH 公钥，并且本地的 SSH 代理正在运行。

2. 克隆结果

执行 git clone 命令后，Git 会为您完成一系列操作：

• 在您执行命令的位置，创建一个与远程仓库同名的文件夹（例如，如果仓库名是 my-project，则会创建 my-project 文件夹）。
• 自动下载远程仓库的所有文件和完整的历史记录。
• Git 会自动设置一个名为 origin 的远程跟踪，指向您克隆的原始 URL。
• 自动签出（checkout）主分支（通常是 main 或 master）。

提示

如果想要在克隆仓库时直接重命名，请输入以下命令：

git clone https://github.com/user/repo-name.git new-repo-name

您只需 cd repo-name 进入新创建的目录，即可开始在这个本地副本上工作。