简介：

本指南面向希望在电脑、手机及其他数码设备上下载安装并正确配置 Git 的用户。文章覆盖 Windows、macOS、主流 Linux 发行版以及手机端（Android/iOS）的安装方法，兼顾命令行与图形客户端，包含常见故障排查与实践建议，适合关注硬件质量、系统使用技巧与故障解决的用户阅读与参考。

工具原料：

系统版本：

- Windows 11（22H2 及以上，包含最新累积更新）

- macOS Sonoma / Ventura（macOS 14/13 家族，Apple Silicon 与 Intel 均适用）

- Ubuntu 24.04 LTS / 22.04 LTS（apt 包管理）

- Fedora 39/40（dnf 包管理）

- Android 13/14（可安装 Termux 或 MGit）

- iOS 16/17（可安装 Working Copy 等 App）

品牌型号：

- Apple MacBook Pro (M3, 2024) 或 MacBook Air M2 (2023)

- Dell XPS 13 Plus (2024) / XPS 15 (2024)

- Lenovo ThinkPad X1 Carbon Gen 12 (2024)

- Microsoft Surface Laptop 6 (2024)

- Samsung Galaxy S24 / S25（Android）

- Google Pixel 8 / 9（Android）

- iPhone 15 / iPhone 16（iOS）

软件版本：

- Git：以官方最新稳定版为准（2024-2025 年间为 2.4x 系列及以上）

- Homebrew（macOS）：最新稳定版

- Git LFS（Large File Storage）：视需求安装最新版

- 常用图形客户端：GitHub Desktop、SourceTree、GitKraken、Working Copy（iOS）等

一、在 Windows 上下载安装与配置

1、下载安装包：前往官方镜像站或 Git 官方网站（https://git-scm.com）下载最新的 Git for Windows 安装程序（64-bit）。

2、运行安装程序：安装过程中常用推荐选项即可。重点选项：

- 选择使用 Git from the command line and also from 3rd-party software（将 Git 添加到 PATH）。

- HTTPS 传输建议使用 Git Credential Manager（便于与 GitHub/GitLab 的凭据管理）。

- 选中与 Windows Terminal / Git Bash 的集成。

3、安装后验证与基础配置：

- 打开 PowerShell 或 Git Bash，运行 git --version 确认安装成功。

- 配置用户信息：git config --global user.name "你的名字"；git config --global user.email "你@example.com"

- 推荐设置凭据缓存：git config --global credential.helper manager-core

4、SSH 密钥（推荐用于 GitHub/GitLab）：

- ssh-keygen -t ed25519 -C "你@example.com"（在 Windows 的 Git Bash 中运行）

- 将公钥 (~/.ssh/id_ed25519.pub) 粘贴到代码托管平台的 SSH Keys 设置中。

二、在 macOS（含 Apple Silicon）上安装与注意事项

1、使用 Homebrew（推荐）：

- 安装 Homebrew 后运行 brew install git。

2、使用 Xcode Command Line Tools：

- 运行 xcode-select --install 会安装 Git 的基本实现（适合临时使用）；长期建议用 Homebrew 安装以便管理版本。

3、Apple Silicon（M1/M2/M3）注意：

- Homebrew 在 Apple Silicon 上默认路径为 /opt/homebrew，安装后请确保 PATH 正确包含该路径：export PATH=/opt/homebrew/bin:$PATH。

4、配置与验证同 Windows，注意 macOS 的 Keychain 可作为凭据助手：git config --global credential.helper osxkeychain

三、在主流 Linux 发行版上安装（Ubuntu/Fedora 等）

1、Ubuntu / Debian 系列：

- sudo apt update；sudo apt install git

2、Fedora / RHEL 系列：

- sudo dnf install git

3、Arch / Manjaro：

- sudo pacman -S git

4、建议：

- 若需要最新版 Git，可从源码编译或使用发行版提供的较新仓库（例如通过 PPA 或第三方仓库）。

- 安装 Git LFS：curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.deb.sh | sudo bash；sudo apt install git-lfs；git lfs install

四、手机端（Android / iOS）的 Git 使用方法

1、Android：

- Terminal 方式：安装 Termux → pkg update && pkg install git。Termux 可在没有根权限的情况下使用命令行 Git。

- 图形客户端：MGit 等可在手机上克隆与浏览仓库，适合查看与小改动。

2、iOS：

- Working Copy（付费/高级功能）是 iOS 上最成熟的 Git 客户端，支持 SSH、OAuth、合并、推送等。

3、场景举例：

- 在旅行或出差时修复小 bug、提交文档更新或 review，手机端配合 SSH key / OAuth 可实现安全同步。

五、安装后常见设置与场景实践

1、常用全局配置：

- git config --global core.autocrlf input（macOS/Linux）或 true（Windows，视团队规范而定）。

- git config --global init.defaultBranch main（确保仓库默认分支一致）。

2、团队协作场景：

- 为减少合并冲突，建议使用 trunk-based 或 Git Flow 流程并在 CI 中强制检查（lint、单元测试）。

3、性能与大文件：

- 对于大二进制文件使用 Git LFS；对于非常大的仓库，考虑使用 sparse-checkout 或 submodules/subtree 分割。

六、常见故障排查（快速诊断）

1、git --version 无输出或命令未找到：

- 检查 PATH 是否包含 Git 安装目录；Windows 重启或重新安装并勾选 PATH 选项。

2、push 时报错 “Permission denied (publickey)”：

- 检查 SSH key 是否生成并添加到远程仓库；本地 ssh -T git@github.com 测试连接。

3、HTTPS 认证频繁弹窗或失败：

- 配置 credential helper（manager-core、osxkeychain、libsecret 等）或改用 SSH。

4、LFS 文件推送失败或速度慢：

- 检查远程仓库是否启用 LFS 支持；网络受限时建议使用公司内网镜像或加速器。

背景知识补充（帮助理解 Git 生态）

1、Git 与远程托管平台的关系：Git 是分布式版本控制系统，本身不包含云服务；GitHub、GitLab、Gitee 等是基于 Git 的托管与协作平台，提供 Issue、CI/CD、权限管理等。

2、SSH 与 HTTPS 的优劣：SSH 更方便无密码自动化（CI、脚本），HTTPS 对于临