跳到主要内容

Git 与 AtomGit 实践:从零到一,单用户操作单仓库

· 阅读需 10 分钟
Kyle

Git 与 AtomGit 实践:从零到一,单用户操作单仓库

本教程适用于 Windows、macOS 和 Linux 平台。

此任务主要是帮助用户在 AtomGit 上从零开始创建并管理一个单一仓库,涵盖单用户操作单仓库的最常用操作流程。

1、注册或登录 AtomGit

网址 https://atomgit.com

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 官网

Linux:

  • 大多数 Linux 发行版预装了 Git。如需安装,可以使用包管理器:
    • Ubuntu/Debian:sudo apt-get install git
    • Fedora:sudo dnf install git
    • CentOS:sudo yum install git

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.pubC:\Users\你的用户名\.ssh\id_随机码.pub
      • MacOS/Linux:~/.ssh/id_rsa.pub
    • 使用以下命令查看公钥内容:
      • Windows:cat C:\Users\你的用户名\.ssh\id_rsa.pubcat C:\Users\你的用户名\.ssh\id_随机码.pub
      • MacOS/Linux:cat ~/.ssh/id_rsa.pub
    • 复制查看显示出来的公钥内容,后续将在AtomGit网站上使用。

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 上创造出更多精彩的项目!

推荐阅读

如果你对本文内容感兴趣,或者希望了解更多相关知识,以下是一些推荐阅读的文章:

  1. Git 与 AtomGit 实践:向上游仓库贡献内容

    • 详细介绍了如何向上游仓库贡献内容的完整流程,包括Fork、克隆、提交更改和提交变更请求等步骤。
  2. Git 与 AtomGit 实践:维护者审核与合并变更请求

    • 介绍了维护者如何审核和合并变更请求的流程,确保项目的质量和一致性。

通过阅读这些文章,你将能够更全面地了解如何使用 Git 和 AtomGit 进行开源项目的贡献和管理。希望这些资源对你有所帮助!