EnderRealm 技术文档

外观

Git 安装与配置 ​

Git 是世界上最流行的版本控制系统，EnderRealm 项目使用 Git 管理代码。

什么是版本控制？ ​

版本控制是一种记录文件变化的系统，它可以：

  • 追踪历史：记录每次修改的内容和时间
  • 多人协作：多人同时修改同一项目而不冲突
  • 版本回退：随时回到之前的某个版本
  • 分支管理：同时开发多个功能而不互相影响

什么是 Git？ ​

Git 是一个分布式版本控制系统，由 Linus Torvalds（Linux 之父）在 2005 年创建。它的特点包括：

  • 分布式：每个开发者都有完整的代码历史
  • 快速：大部分操作在本地完成
  • 安全：使用 SHA-1 保证数据完整性
  • 灵活：支持多种工作流程

为什么选择 Git？ ​

  • 行业标准：绝大多数开源项目使用 Git
  • 功能强大：支持分支、合并、变基等高级操作
  • 工具丰富：GitHub、GitLab、Bitbucket 等平台支持
  • 学习资源多：大量教程和文档

安装 Git ​

Windows ​

方法一：官方安装包（推荐） ​

  1. 访问 Git 官网
  2. 下载安装包
  3. 运行安装包，按提示完成安装
    • 建议勾选"Add Git to PATH"
    • 选择默认编辑器（推荐 VS Code 或 Vim）
    • 选择"Use Git from the Windows Command Prompt"

方法二：使用包管理器 ​

powershell
# 使用 winget
winget install Git.Git

# 使用 scoop
scoop install git

# 使用 chocolatey
choco install git

macOS ​

方法一：使用 Homebrew（推荐） ​

bash
# 安装 Homebrew（如果尚未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Git
brew install git

方法二：Xcode Command Line Tools ​

bash
xcode-select --install

方法三：官方安装包 ​

  1. 访问 Git 官网
  2. 下载安装包
  3. 运行安装包，按提示完成安装

Linux ​

Ubuntu/Debian ​

bash
sudo apt update
sudo apt install git

CentOS/RHEL/Fedora ​

bash
# CentOS/RHEL
sudo yum install git

# Fedora
sudo dnf install git

Arch Linux ​

bash
sudo pacman -S git

配置 Git ​

安装完成后，需要配置用户信息：

bash
# 设置用户名（用于提交记录）
git config --global user.name "你的名字"

# 设置邮箱（用于提交记录）
git config --global user.email "your.email@example.com"

# 设置默认编辑器（可选）
git config --global core.editor "code --wait"  # VS Code
# git config --global core.editor "vim"        # Vim
# git config --global core.editor "nano"       # Nano

# 设置默认分支名（可选）
git config --global init.defaultBranch main

# 启用颜色输出（可选）
git config --global color.ui auto

验证安装 ​

打开终端，运行以下命令：

bash
# 验证 Git 版本
git --version

# 查看配置
git config --list

应该看到类似输出：

git version 2.x.x

Git 基本概念 ​

在继续之前，了解一些基本概念：

仓库（Repository） ​

仓库是 Git 用来存储项目历史的地方。每个项目都有一个 .git 目录，包含所有版本信息。

工作区（Working Directory） ​

工作区是你当前编辑的文件所在的目录。

暂存区（Staging Area） ​

暂存区是一个临时区域，用于准备下一次提交。

提交（Commit） ​

提交是保存到历史记录的一个快照，包含修改的内容和提交信息。

分支（Branch） ​

分支是独立的开发线路，可以同时开发多个功能而不互相影响。

常用 Git 命令 ​

以下是一些最常用的 Git 命令：

bash
# 初始化仓库
git init

# 克隆仓库
git clone <url>

# 查看状态
git status

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

# 提交更改
git commit -m "提交信息"

# 查看历史
git log

# 创建分支
git branch <branch-name>

# 切换分支
git checkout <branch-name>

# 合并分支
git merge <branch-name>

常见问题 ​

Q: Git 和 GitHub 有什么区别？ ​

A: Git 是版本控制工具，GitHub 是基于 Git 的代码托管平台。Git 在本地运行，GitHub 提供云端存储和协作功能。

Q: 如何学习更多 Git 命令？ ​

A: 推荐以下学习资源：

Q: 忘记了 Git 命令怎么办？ ​

A: 使用以下命令获取帮助：

bash
# 查看所有命令
git help

# 查看特定命令的帮助
git help <command>
git <command> --help

推荐学习资源 ​

下一步 ​

Git 安装配置完成后，让我们继续学习 Python 环境。

© 2022-present EnderRealm. All rights reserved.