安装

  • 先选择自己的系统安装,安装后,一定要配置全局!

一、Windows 系统安装 Git(演示)

步骤 1:下载安装包

  1. 访问 Git 官网img
  2. 点击 Download for Windows,下载最新版安装包(如 Git-2.47.1.2-64-bit.exe)。img

步骤 2:运行安装程序

  1. 双击安装包,启动安装向导。img
  2. 关键配置选项(按顺序设置):
    • 安装路径:默认路径为 C:\Program Files\Git\,建议保持默认。
      • 注意:路径中不要包含中文或空格。img
    • 选择组件
      • 桌面图标:在桌面上放一个图标,方便你快速打开 Git。
      • Windows 文件夹集成
        • 在这里打开 Git 命令行:在文件夹里右键点击,可以直接打开命令行工具。
        • 在这里打开 Git 图形界面:在文件夹里右键点击,可以直接打开图形界面工具。
      • 大文件支持:帮助你处理大文件的版本控制。
      • 关联 Git 配置文件:让文本编辑器自动打开 Git 的配置文件。
      • 关联 Shell 脚本文件:让 Shell 脚本文件可以用命令行工具运行。
      • 检查更新:每天检查是否有 Git 的新版本。
      • 添加 Git 命令行配置到 Windows 命令行工具:在 Windows 命令行工具中添加 Git 命令行的配置。
      • Scalar 插件:一个帮助管理大项目的插件。img
    • 开始菜单中的名称,直接nextimg
    • 默认编辑器
      • 一般建议选择 Use Visual Studio Code as Git's default editor(推荐)或其他编辑器(如 Notepad++)。
      • 这里选择直接next,默认Vim即可img
    • 初始分支的名称
      • 在创建新仓库时希望 Git 使用什么名称作为初始分支。
      • Let Git decide:让 Git 使用它的默认分支名称(目前是“master”)。未来 Git 计划更改这个默认名称,使其更具包容性。
      • Override the default branch name for new repositories:覆盖默认分支名称,你可以指定一个新的名称。许多团队已经将默认分支名称更改为“main”、“trunk”或“development”等。这个设置不会影响已经存在的仓库。
      • 简单来说,你可以选择让 Git 自己决定初始分支的名称,或者你可以自己指定一个名称,比如“main”。
      • 点击“Next”进入下一个界面img
    • 调整 PATH 环境变量
      • 选择 Git from the command line and also from 3rd-party software(确保全局可用)。img
    • 选择SSH可执行文件,nextimg
    • 选择HTTPS后端传输,nextimg
    • 换行符处理
      • 选择 Checkout Windows-style, commit Unix-style line endings(避免跨平台换行符冲突)。img
    • 终端模拟器
      • 选择 Use MinTTY (the default terminal of MSYS2)(Git Bash 的默认终端)。img
    • 其他选项:保持默认设置。img
  3. 点击 Finish 完成安装。img

这个界面表示 Git 已经安装完成。

  1. Launch Git Bash:勾选这个选项可以在安装完成后直接启动 Git Bash。
  2. View Release Notes:勾选这个选项可以查看发行说明。

步骤 3:验证安装

  1. 打开 Git Bash(桌面右键或开始菜单)。

  2. 输入以下命令:

    git --version

    点击并拖拽以移动

    • 显示版本号(如 git version 2.47.1.windows.2)即安装成功。img

二、macOS 系统(不演示)

步骤 1:通过 Homebrew 安装(推荐)

  1. 安装 Homebrew(若未安装):

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

    点击并拖拽以移动

  2. 通过 Homebrew 安装 Git

    brew install git

    点击并拖拽以移动

步骤 2:通过官方安装包

  1. 访问 Git 官网,下载 .dmg 安装包。
  2. 双击安装包,按提示完成安装。

步骤 3:验证安装

  1. 打开终端(Terminal)。

  2. 输入:

    git --version

    点击并拖拽以移动

    • 显示版本号即成功。

三、Linux 系统(不演示)

步骤 1:通过包管理器安装

  1. Debian/Ubuntu

    sudo apt update && sudo apt install git

    点击并拖拽以移动

  2. CentOS/Fedora

    1
    2
    sudo yum install git        # CentOS
    sudo dnf install git # Fedora

    点击并拖拽以移动

步骤 2:验证安装

git --version

点击并拖拽以移动


安装后配置==(所有系统必做)==

步骤 1:设置全局用户名和邮箱

  1. 打开终端(Windows 用 Git Bash)。

  2. 输入以下命令(替换为你的信息):

    1
    2
    git config --global user.name "Your Name"
    git config --global user.email "your.email@example.com"

    点击并拖拽以移动

    • 作用:提交代码时标识作者身份,必须与代码托管平台(如 GitHub)的注册邮箱一致。

步骤 2:检查配置

git config --list

点击并拖拽以移动

  • 确认输出中包含 user.nameuser.email 的配置。

注意事项总结

  1. 换行符问题

    • Windows 用户务必选择 Checkout Windows-style, commit Unix-style,避免跨平台协作时文件换行符混乱。

    • 手动修正命令:

      git config --global core.autocrlf true

      点击并拖拽以移动

  2. SSH 密钥配置(推荐)

    • 生成 SSH 密钥并添加到 GitHub/GitLab:

      1
      2
      ssh-keygen -t ed25519 -C "your.email@example.com"
      cat ~/.ssh/id_ed25519.pub

      点击并拖拽以移动

    • 将公钥粘贴到代码托管平台的 SSH Keys 设置中。

  3. 代理配置(如需)

    • 若需通过代理访问网络:

      1
      2
      git config --global http.proxy http://proxy.example.com:8080
      git config --global https.proxy https://proxy.example.com:8080

      点击并拖拽以移动

  4. 路径与权限

    • 安装路径避免中文或空格(如 C:\Program Files\Git 是安全的)。
    • 不要以管理员身份运行 Git,除非必要。

首次使用测试

  1. 创建本地仓库

    1
    2
    3
    4
    5
    mkdir my-project && cd my-project
    git init
    echo "# Hello Git" > README.md
    git add README.md
    git commit -m "Initial commit"

    点击并拖拽以移动

  2. 推送至远程仓库(需提前在 GitHub 等平台创建仓库):

    1
    2
    git remote add origin https://github.com/your-username/your-repo.git
    git push -u origin main

    点击并拖拽以移动


常见问题解决

  • 安装失败或命令未找到
    检查环境变量是否包含 Git 的安装路径(默认路径为 C:\Program Files\Git\cmd)。
  • Git GUI 无法启动
    尝试重新安装并勾选所有默认组件。
  • 提交时提示邮箱无效
    检查 user.email 配置是否与代码托管平台注册邮箱一致。