Git 与 AtomGit 实践：从零到一，单用户操作单仓库
本教程适用于 Windows、macOS 和 Linux 平台。
此任务主要是帮助用户在 AtomGit 上从零开始创建并管理一个单一仓库，涵盖单用户操作单仓库的最常用操作流程。
1、注册或登录 AtomGit
2、验证手机号码和邮箱的正确性
在 AtomGit 上产生内容前，需先验证手机号码和邮箱的正确性。如果没有验证过，在AtomGit网站上会有弹出提醒，如果没有弹出提醒，请按照以下步骤进行验证：
- 点击AtomGit网站界面右上角的头像
- 进入“个人中心”
- 选择“基本信息”
- 进入“帐号绑定”
- 检查验证状态或修改手机号和邮箱
3、创建仓库
1）点击“+”按钮
- 在 AtomGit 界面的右上角，点击“+”按钮。
2）新建代码库
- 选择“新建代码库”。
3）填写代码库详细信息
- 代码库名称：支持中英文。
- 归属：默认是当前登录的账户。
- 路径：只能包含字母、数字、''、'.'和'-'，且必须以字母、数字或''开头。
- 关联社区：（可选）。
- 公开性：根据实际情况设置，本次练习作业需设置为公开。
- 代码库描述：自行输入描述内容。
- 创建README.md：系统会自动创建一个Markdown文件。
- 创建 .gitignore：此选项为可选。
- 添加开源许可证：根据实际情况选择一个，非常重要。
4）确认创建
- 点击“确定”以完成代码库的创建。
4、Git 环境准备
1）检查Git环境
Windows：
- 按下 Win 键打开开始菜单。
- 输入 PowerShell。
- 在搜索结果中，右键点击 Windows PowerShell，选择 以管理员身份运行。
- 在弹出的提示中点击 是。
MacOS：
- 打开 终端（Terminal）应用。
- 可以通过 Spotlight（按下 Command + 空格）搜索 "Terminal" 来打开。
Linux：
- 打开终端（Terminal）。
- 在大多数发行版中，可以使用快捷键 Ctrl + Alt + T 打开终端。
在终端/PowerShell 中输入以下命令并回车：
git --version
结果判断：
- 如果显示 Git 版本号（如
git version 2.x.x），表示 Git 已正确安装。 - 如果出现错误信息，表示 Git 未安装。
2）安装Git
Windows：
- 如果Git未安装，打开浏览器访问以下链接下载Git安装包： 下载Git-2.47.1-64-bit.exe
- 下载完成后，解压并双击运行安装包。
- 在安装向导中，依次点击 Next。
- 在 Select Components 界面，确保所有选项均已勾选，以便后续操作更方便。
- 继续点击 Next 直至安装完成。
- 安装完成后，重新执行 检查Git环境 步骤以确认安装成功。
MacOS：
- MacOS 通常预装了 Git。如需安装或更新，可以：
- 通过 Homebrew 安装：
brew install git - 或下载 Git 安装包：访问 Git 官网
- 通过 Homebrew 安装：
Linux：
- 大多数 Linux 发行版预装了 Git。如需安装，可以使用包管理器：
- Ubuntu/Debian：
sudo apt-get install git - Fedora：
sudo dnf install git - CentOS：
sudo yum install git
- Ubuntu/Debian：
3）配置Git
- 打开终端（Windows 用户使用 PowerShell）。
- 执行以下命令生成SSH密钥：
ssh-keygen -t rsa -C "your_email@example.com" - 按提示一路 Enter 键，使用默认设置生成SSH Key。
- 复制SSH公钥：
- 生成的SSH Key文件路径：
- Windows：
C:\Users\你的用户名\.ssh\id_rsa.pub或C:\Users\你的用户名\.ssh\id_随机码.pub - MacOS/Linux：
~/.ssh/id_rsa.pub
- Windows：
- 使用以下命令查看公钥内容：
- Windows：
cat C:\Users\你的用户名\.ssh\id_rsa.pub或cat C:\Users\你的用户名\.ssh\id_随机码.pub - MacOS/Linux：
cat ~/.ssh/id_rsa.pub
- Windows：
- 复制查看显示出来的公钥内容，后续将在AtomGit网站上使用。
- 生成的SSH Key文件路径：
4）在AtomGit网站上配置SSH Key
- 在AtomGit网站上点击右上角头像->个人中心->安全中心SSH Keys->添加 SSH 公钥->将刚才复制的SSH Key粘贴到“公钥”文本框中->点击“确定”。
5）测试SSH Key是否生效
Windows/Linux/MacOS：
- 在终端/PowerShell中输入下面命令并回车，如果看到"successfully"，表明SSH Key配置成功。
ssh -T git@atomgit.com
6）配置Git用户名和邮箱
Windows/Linux/MacOS：
- 在终端/PowerShell中分别输入下面每行命令并回车，其中name和email的内容可以随便写，但是推荐和您的AtomGit账户名和邮箱一致。
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
5、本地操作仓库
1）获取仓库的 Git 地址
- 在第三步创建的仓库页面，点击右上角的"克隆/下载"按钮。
- 确保选择了"SSH"选项。
- 页面会显示类似"git@atomgit.com:username/repository"格式的地址（注意：不要直接复制这里的示例，要使用你在 AtomGit 网站上看到的实际地址，其中 username 是你的 AtomGit 用户名，repository 是你的仓库名称）。
- 点击地址右侧的复制按钮复制你的仓库 SSH 地址。
2）将仓库克隆到电脑本地
Windows：
- 在 PowerShell 中执行（使用你从 AtomGit 网站上复制的实际仓库地址）：
git clone <在AtomGit网站上复制的仓库地址>
MacOS/Linux：
- 在终端中执行（使用你从 AtomGit 网站上复制的实际仓库地址）：
git clone <在AtomGit网站上复制的仓库地址>
3）进入仓库目录
Windows：
- 在 PowerShell 中执行（使用你的实际仓库名称）：
cd <你的仓库名称>
MacOS/Linux：
- 在终端中执行（使用你的实际仓库名称）：
cd <你的仓库名称>
4）打开目录并在里添加文件或者更新文件
Windows：
- 在 PowerShell 中执行：
start .
MacOS/Linux：
- 请使用合适的编辑器操作目录的内容。
对于所有平台：
- 此时你可以在当前目录下：
- 添加新的文件或子文件夹
- 删除已有的文件或子文件夹
- 修改已有文件的内容
- 重命名文件或子文件夹
例如：
- 添加一个新文件test.txt，写入"hello world"
- 创建一个新的子文件夹docs
- 修改README.md文件的内容
- 删除不需要的文件
5）提交文件
Windows/Linux/MacOS：
- 在终端/PowerShell中执行以下命令提交文件：
git add .
git commit -m "在这里写一句你喜欢的或者能表达本次更新内容的提交注释"
git push
6）查看更新结果
- 现在你可以访问 AtomGit 网站查看你的仓库更新了。
至此，你已经成功迈出了使用 Git 的第一步。随着不断练习，你会发现 Git 是一个非常强大且有趣的工具。期待看到你在 AtomGit 上创造出更多精彩的项目！
推荐阅读
如果你对本文内容感兴趣，或者希望了解更多相关知识，以下是一些推荐阅读的文章：
- 详细介绍了如何向上游仓库贡献内容的完整流程，包括Fork、克隆、提交更改和提交变更请求等步骤。
- 介绍了维护者如何审核和合并变更请求的流程，确保项目的质量和一致性。
通过阅读这些文章，你将能够更全面地了解如何使用 Git 和 AtomGit 进行开源项目的贡献和管理。希望这些资源对你有所帮助！