Git 安装与配置

在开始用 Git 之前,得先在电脑上装好它,再做几项一次性配置(身份、SSH 密钥)。这一章不涉及代码管理,只是"搭地基"——配好之后,后面所有章节都能顺畅跑。

1. 安装 Git

Git 是跨平台的,在 Windows、macOS、Linux 上都能装。下面分别介绍。

macOS

# macOS:推荐用 Homebrew 安装(版本最新)
brew install git

# 如果没装 Homebrew,先装它(一行命令):
# /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 或者装 Xcode Command Line Tools(自带 Git,但版本可能偏旧)
xcode-select --install

# 验证安装
git --version
# 输出: git version 2.45.1

Linux

# Debian / Ubuntu
sudo apt update && sudo apt install git

# Fedora
sudo dnf install git

# CentOS / RHEL
sudo yum install git

# Arch Linux
sudo pacman -S git

# 验证
git --version

Windows

Windows 用户直接去官网下载安装包:git-scm.com/download/win。安装时一路"Next"即可,几个关键选项:

2. 配置身份(必做)

装好 Git 后,第一件事是告诉它"你是谁"。因为每次 commit 都会记录作者的名字和邮箱,这是协作时识别贡献者的依据。不配置的话,commit 会报错或显示空白作者。

# 配置身份:第一次使用必做!否则 commit 没有作者
# --global 表示对当前用户的所有仓库生效(写在 ~/.gitconfig)
git config --global user.name  "你的名字"
git config --global user.email "you@example.com"

# 邮箱建议用 GitHub 注册邮箱,这样提交能关联到你的 GitHub 账号

# 查看所有配置
git config --list
# 输出示例:
# user.name=你的名字
# user.email=you@example.com
# core.editor=code --wait

# 只看某一项
git config user.name

# 修改默认分支名(新版 Git 默认 master,社区约定改 main)
git config --global init.defaultBranch main

# 让 git 输出带颜色,更易读
git config --global color.ui auto

# 设置默认编辑器(提交信息会用它打开)
git config --global core.editor "code --wait"   # VS Code
git config --global core.editor "vim"            # Vim
git config --global core.editor "nano"           # Nano

几个细节:

3. 配置 SSH 密钥(强烈推荐)

推送代码到 GitHub 时,如果用 HTTPS 地址,每次都要输密码(现在 GitHub 已不接受账号密码,必须用 Personal Access Token,很麻烦)。配好 SSH 后一次配好,终身免密,是长期开发的最佳选择。

# 1. 生成 SSH 密钥(推荐 ed25519 算法,更短更安全)
ssh-keygen -t ed25519 -C "you@example.com"
# 一路回车即可(密码可留空,方便;或设置一个,更安全)
# 密钥会生成在:
#   ~/.ssh/id_ed25519      (私钥,绝对不能泄露!)
#   ~/.ssh/id_ed25519.pub  (公钥,贴到 GitHub)

# 2. 查看并复制公钥内容
cat ~/.ssh/id_ed25519.pub
# 输出: ssh-ed25519 AAAAC3NzaC1... you@example.com

# 3. 在 GitHub 添加公钥:
#    Settings → SSH and GPG keys → New SSH key
#    把上面 cat 输出的整行粘进去,起个名字(如 "MacBook")

# 4. 测试连接
ssh -T git@github.com
# 输出: Hi you! You've successfully authenticated...

SSH 的原理是非对称加密:私钥( id_ed25519)留在本地绝不外传,公钥(.pub)贴到 GitHub。push 时 Git 用私钥"签名",GitHub 用公钥验证——既证明"是你",又不用传密码。

重要:私钥文件(~/.ssh/id_ed25519,没有 .pub 后缀那个)绝对不能泄露,等于你 GitHub 账号的钥匙。一旦泄露,立刻去 GitHub 删掉对应公钥并重新生成。

4. HTTPS 与凭证管理

如果不想配 SSH,也可以用 HTTPS。从 2021 年起 GitHub 不再接受账号密码,需要用 Personal Access Token(PAT)代替密码。生成方式:GitHub → Settings → Developer settings → Personal access tokens → Generate new token。

更省心的办法是装 Git Credential Manager(GCM),它会弹出浏览器让你登录一次,之后自动记住 token。Windows 版 Git 安装包自带 GCM;macOS 可用 brew install --cask git-credential-manager。

5. 配置别名(提效)

Git 命令有时很长(如 log --oneline --graph --all)。给它起个短的别名,长期下来能省大量敲键时间:

# 给常用命令起别名,大幅提升效率
git config --global alias.st  "status -sb"
git config --global alias.co  "checkout"
git config --global alias.br  "branch"
git config --global alias.ci  "commit"
git config --global alias.lg  "log --oneline --graph --all --decorate"

# 之后只需:
git st          # 等价于 git status -sb
git lg          # 漂亮的分支图
git ci -m "msg" # 等价于 git commit -m "msg"

# 删除某个别名
git config --global --unset alias.st

6. 检查安装是否成功

装完做几个验证,确保一切就绪:

三项都通过,恭喜你,环境搭好了,可以开始建仓库了。

← 上一篇 Git 简介与历史

下一篇 Git 基础命令 →

✈️💬