Git 从安装到配置新手完整指南本教程将带你从零开始安装和配置 Git包含每个步骤的详细说明和新手建议。目录下载与安装安装选项详解安装后的基础配置新手常见问题与建议参考资料与扩展阅读下载与安装获取最新稳定版访问 Git 官网下载页面Git - Windows 安装点击下载按钮获取最新稳定版安装程序启动安装程序下载完成后双击安装文件启动安装向导直接默认 “Next” 即可。选择安装目录安装路径可以自动定义路径自定义路径时避免包含中文或空格。选择完后直接Next 即可安装选项详解选择安装组件以下是默认的组件配置默认设置说明如果你不确认是否有需求直接默认 “Next” 即可。核心组件建议保持默认组件状态说明Windows Explorer integration右键菜单✅ 已勾选日常最核心功能任何文件夹右键就能打开 Git 命令行或图形界面Git LFS 大文件支持✅ 已勾选以后存图片、数据集、模型、视频不会炸仓库关联 .git 配置文件到文本编辑器✅ 已勾选改用户名、邮箱、仓库配置时直接双击打开.sh 脚本用 Bash 运行✅ 已勾选写自动化脚本、部署小工具会用到Scalar 超大仓库插件✅ 已勾选占用空间极小下载大型开源项目会提速可选组件根据需求选择组件状态说明Additional icons桌面图标❌ 未勾选桌面放 Git 图标用处很小右键文件夹就能打开每日检查更新❌ 未勾选不用每天弹窗提醒更新每隔半年手动更一次即可Windows Terminal 添加 Git Bash 配置❌ 未勾选Win11 用户可勾选Win10 或只用 Git Bash 不影响使用选择开始菜单文件夹保持默认设置点击 “Next” 即可。选择 Git 的默认编辑器重要提示选择正式版的 VS Code不要选成测试版。如果没有安装 VS Code可以安装一个 VS Code推荐或选择Use Notepad as Gits default editor设置新建仓库的默认初始分支名称建议选择第二个的 “main” 。调整环境变量选择默认选项即可点击 “Next” 进入下一步。选择 SSH 可执行文件保持默认设置Git 会自动选择合适的 SSH 客户端。选择 HTTPS 后端传输这里选择 Git 使用哪套 SSL/TLS 库处理 HTTPS 协议连接。配置行尾符号转换重要这是跨平台协作的关键设置。操作系统推荐设置Windows 用户选择 “Checkout Windows-style, commit Unix-style line endings”Linux/Mac 用户选择 “Checkout as-is, commit Unix-style line endings”配置 Git Bash 使用的终端模拟器建议选择默认的 MinTTY它提供更好的终端体验。选择 “git pull” 的默认行为建议选择 “Default (fast-forward or merge)”这是最常见的工作流。选择帮助凭证推荐选择Git Credential Manager这样可以自动处理身份验证避免频繁输入凭据安全存储你的 GitHub/GitLab 密码配置额外链接的选项保持默认设置点击 “Next” 进入下一步。安装过程点击 “Install” 开始安装等待进度条完成。安装完成安装完成后点击 “Finish” 退出安装向导。验证安装打开命令行Win R输入cmd或powershell运行以下命令验证安装git --version如果显示版本信息说明安装成功安装后的基础配置安装完成后需要进行一些基础配置。这些配置只需要设置一次但非常重要。配置级别说明Git 有三个配置级别优先级从高到低级别文件位置作用范围仓库级别.git/config只对当前仓库有效用户级别~/.gitconfig对当前用户的所有仓库有效系统级别/etc/gitconfig对所有用户有效建议大多数配置使用用户级别--global即可。必须配置用户信息这是最重要的配置你的每次提交都会包含这些信息。设置用户名# 设置你的用户名将显示在你的提交记录中gitconfig--globaluser.name你的名字# 示例gitconfig--globaluser.nameZhang San设置邮箱# 设置你的邮箱将显示在你的提交记录中gitconfig--globaluser.email你的邮箱example.com# 示例gitconfig--globaluser.emailzhangsanexample.com重要提示验证配置# 查看当前用户名gitconfig user.name# 查看当前邮箱gitconfig user.email如果只是刚开始使用到这里配置验证已经完成了下面的很多部分在安装过程中我们也设置过补充汉化可选Git BashGit Bash自带中文语言包我们只需要通过选项选择中文即可。在Git Bash鼠标右键点击【Options…】。点击【Window】,在【UI language】选择【zh-CN】也就是简体中文如果是想要选择繁体中文就选择【zh-TW】。汉化后右键菜单发现都已变成中文。以下配置作为补充应对一些其他的可能会出现的问题必须配置换行符处理Windows 用户Windows 和 Linux/Mac 使用不同的换行符这个配置很重要。推荐设置# Windows 用户推荐设置# 提交时转换为 Unix 格式检出时不转换gitconfig--globalcore.autocrlf input其他选项选项命令适用场景truegit config --global core.autocrlf true适合纯 Windows 开发inputgit config --global core.autocrlf input适合 Windows 用户推荐falsegit config --global core.autocrlf false适合跨平台团队必须配置默认分支名称设置新仓库的默认分支名称。# 设置默认分支名为 main行业标准gitconfig--globalinit.defaultBranch main说明推荐配置可选以下配置不是必须的但可以提升使用体验。编辑器设置设置 Git 使用的默认编辑器用于编写提交信息、解决冲突等。VS Code 用户推荐# 设置 VS Code 为默认编辑器gitconfig--globalcore.editorcode --waitNotepad 用户# 设置 Notepad 为默认编辑器gitconfig--globalcore.editorC:/Program Files/Notepad/notepad.exe -multiInst -notabbar -nosession -noPluginVim 用户# Vim 是 Git 的默认编辑器通常不需要额外设置# 如果需要设置gitconfig--globalcore.editorvim中文文件名支持如果你的项目包含中文文件名这个配置很重要。# 正确显示中文文件名gitconfig--globalcore.quotepathfalse# 设置提交信息使用中文gitconfig--globali18n.commitencoding utf-8gitconfig--globali18n.logoutputencoding utf-8颜色设置让 Git 输出更美观易于阅读。# 启用颜色输出gitconfig--globalcolor.ui auto别名设置设置常用命令的别名提高工作效率。# 常用别名设置gitconfig--globalalias.st statusgitconfig--globalalias.co checkoutgitconfig--globalalias.br branchgitconfig--globalalias.ci commitgitconfig--globalalias.lglog --oneline --graph --allgitconfig--globalalias.lastlog -1 HEADgitconfig--globalalias.unstagereset HEAD --使用示例原命令使用别名git statusgit stgit checkout maingit co maingit commit -m messagegit ci -m message查看和管理配置查看所有配置# 查看所有配置gitconfig--list# 查看特定配置gitconfig user.namegitconfig user.email# 查看配置文件位置gitconfig--list--show-origin编辑配置文件# 打开全局配置文件进行编辑gitconfig--global--edit删除配置# 删除特定配置gitconfig--global--unsetuser.name配置文件位置了解配置文件的位置有助于高级管理级别文件位置说明全局配置~/.gitconfig用户级别系统配置/etc/gitconfig系统级别仓库配置.git/config仓库级别验证配置配置完成后建议验证一下# 查看所有配置gitconfig--list# 测试编辑器设置# 创建一个测试仓库mkdirtest-repocdtest-repogitinit# 创建一个文件并提交测试编辑器是否正常echotesttest.txtgitaddtest.txtgitcommit# 这时应该打开你设置的编辑器常见配置场景场景1个人开发者# 基础配置gitconfig--globaluser.nameYour Namegitconfig--globaluser.emailyour.emailexample.comgitconfig--globalcore.editorcode --waitgitconfig--globalcore.autocrlf inputgitconfig--globalinit.defaultBranch main场景2公司开发者# 使用公司邮箱和特定配置gitconfig--globaluser.nameYour Namegitconfig--globaluser.emailyour.namecompany.comgitconfig--globalcore.editorcode --waitgitconfig--globalcore.autocrlf inputgitconfig--globalinit.defaultBranch main# 可能需要配置代理gitconfig--globalhttp.proxy http://proxy.company.com:8080场景3跨平台团队# 不转换换行符保持原样gitconfig--globalcore.autocrlffalsegitconfig--globalcore.eol lf配置备份与迁移如果你需要在多台电脑上使用相同的 Git 配置# 导出配置gitconfig--global--listgitconfig.txt# 在其他电脑上导入# 可以手动编辑 ~/.gitconfig 文件# 或者使用脚本批量设置新手常见问题与建议常见问题1. 为什么我的 Git 命令不识别解决方案确保 Git 已正确安装重新打开命令行窗口检查环境变量是否包含 Git 路径2. 如何解决中文文件名显示问题# 设置 Git 正确处理中文文件名gitconfig--globalcore.quotepathfalse3. 如何查看 Git 版本git--version4. 如何获取帮助# 查看帮助文档githelp# 查看特定命令帮助githelpconfiggithelpinit新手建议学习路径建议先掌握基础命令init,add,commit,status,log理解工作区、暂存区、仓库的概念学习分支管理branch,checkout,merge了解远程仓库操作clone,pull,push最佳实践提交信息要清晰用简洁的语言描述你的更改小步提交每个提交完成一个完整的功能或修复不要提交敏感信息密码、密钥等不要提交到仓库定期备份重要项目记得推送到远程仓库避免的常见错误不要直接修改**.git**目录这是 Git 的内部文件不要忘记**git add**修改文件后需要先暂存再提交不要在错误的分支上提交先检查当前分支不要强制推送force push除非你确定你知道自己在做什么下一步学习完成安装配置后建议继续学习Git 基础命令init,add,commit,status,log分支管理branch,checkout,merge,rebase远程仓库clone,pull,push,fetch高级操作stash,cherry-pick,bisect最后更新2026年07月17日
Git 从安装到配置新手完整指南本教程将带你从零开始安装和配置 Git包含每个步骤的详细说明和新手建议。目录下载与安装安装选项详解安装后的基础配置新手常见问题与建议参考资料与扩展阅读下载与安装获取最新稳定版访问 Git 官网下载页面Git - Windows 安装点击下载按钮获取最新稳定版安装程序启动安装程序下载完成后双击安装文件启动安装向导直接默认 “Next” 即可。选择安装目录安装路径可以自动定义路径自定义路径时避免包含中文或空格。选择完后直接Next 即可安装选项详解选择安装组件以下是默认的组件配置默认设置说明如果你不确认是否有需求直接默认 “Next” 即可。核心组件建议保持默认组件状态说明Windows Explorer integration右键菜单✅ 已勾选日常最核心功能任何文件夹右键就能打开 Git 命令行或图形界面Git LFS 大文件支持✅ 已勾选以后存图片、数据集、模型、视频不会炸仓库关联 .git 配置文件到文本编辑器✅ 已勾选改用户名、邮箱、仓库配置时直接双击打开.sh 脚本用 Bash 运行✅ 已勾选写自动化脚本、部署小工具会用到Scalar 超大仓库插件✅ 已勾选占用空间极小下载大型开源项目会提速可选组件根据需求选择组件状态说明Additional icons桌面图标❌ 未勾选桌面放 Git 图标用处很小右键文件夹就能打开每日检查更新❌ 未勾选不用每天弹窗提醒更新每隔半年手动更一次即可Windows Terminal 添加 Git Bash 配置❌ 未勾选Win11 用户可勾选Win10 或只用 Git Bash 不影响使用选择开始菜单文件夹保持默认设置点击 “Next” 即可。选择 Git 的默认编辑器重要提示选择正式版的 VS Code不要选成测试版。如果没有安装 VS Code可以安装一个 VS Code推荐或选择Use Notepad as Gits default editor设置新建仓库的默认初始分支名称建议选择第二个的 “main” 。调整环境变量选择默认选项即可点击 “Next” 进入下一步。选择 SSH 可执行文件保持默认设置Git 会自动选择合适的 SSH 客户端。选择 HTTPS 后端传输这里选择 Git 使用哪套 SSL/TLS 库处理 HTTPS 协议连接。配置行尾符号转换重要这是跨平台协作的关键设置。操作系统推荐设置Windows 用户选择 “Checkout Windows-style, commit Unix-style line endings”Linux/Mac 用户选择 “Checkout as-is, commit Unix-style line endings”配置 Git Bash 使用的终端模拟器建议选择默认的 MinTTY它提供更好的终端体验。选择 “git pull” 的默认行为建议选择 “Default (fast-forward or merge)”这是最常见的工作流。选择帮助凭证推荐选择Git Credential Manager这样可以自动处理身份验证避免频繁输入凭据安全存储你的 GitHub/GitLab 密码配置额外链接的选项保持默认设置点击 “Next” 进入下一步。安装过程点击 “Install” 开始安装等待进度条完成。安装完成安装完成后点击 “Finish” 退出安装向导。验证安装打开命令行Win R输入cmd或powershell运行以下命令验证安装git --version如果显示版本信息说明安装成功安装后的基础配置安装完成后需要进行一些基础配置。这些配置只需要设置一次但非常重要。配置级别说明Git 有三个配置级别优先级从高到低级别文件位置作用范围仓库级别.git/config只对当前仓库有效用户级别~/.gitconfig对当前用户的所有仓库有效系统级别/etc/gitconfig对所有用户有效建议大多数配置使用用户级别--global即可。必须配置用户信息这是最重要的配置你的每次提交都会包含这些信息。设置用户名# 设置你的用户名将显示在你的提交记录中gitconfig--globaluser.name你的名字# 示例gitconfig--globaluser.nameZhang San设置邮箱# 设置你的邮箱将显示在你的提交记录中gitconfig--globaluser.email你的邮箱example.com# 示例gitconfig--globaluser.emailzhangsanexample.com重要提示验证配置# 查看当前用户名gitconfig user.name# 查看当前邮箱gitconfig user.email如果只是刚开始使用到这里配置验证已经完成了下面的很多部分在安装过程中我们也设置过补充汉化可选Git BashGit Bash自带中文语言包我们只需要通过选项选择中文即可。在Git Bash鼠标右键点击【Options…】。点击【Window】,在【UI language】选择【zh-CN】也就是简体中文如果是想要选择繁体中文就选择【zh-TW】。汉化后右键菜单发现都已变成中文。以下配置作为补充应对一些其他的可能会出现的问题必须配置换行符处理Windows 用户Windows 和 Linux/Mac 使用不同的换行符这个配置很重要。推荐设置# Windows 用户推荐设置# 提交时转换为 Unix 格式检出时不转换gitconfig--globalcore.autocrlf input其他选项选项命令适用场景truegit config --global core.autocrlf true适合纯 Windows 开发inputgit config --global core.autocrlf input适合 Windows 用户推荐falsegit config --global core.autocrlf false适合跨平台团队必须配置默认分支名称设置新仓库的默认分支名称。# 设置默认分支名为 main行业标准gitconfig--globalinit.defaultBranch main说明推荐配置可选以下配置不是必须的但可以提升使用体验。编辑器设置设置 Git 使用的默认编辑器用于编写提交信息、解决冲突等。VS Code 用户推荐# 设置 VS Code 为默认编辑器gitconfig--globalcore.editorcode --waitNotepad 用户# 设置 Notepad 为默认编辑器gitconfig--globalcore.editorC:/Program Files/Notepad/notepad.exe -multiInst -notabbar -nosession -noPluginVim 用户# Vim 是 Git 的默认编辑器通常不需要额外设置# 如果需要设置gitconfig--globalcore.editorvim中文文件名支持如果你的项目包含中文文件名这个配置很重要。# 正确显示中文文件名gitconfig--globalcore.quotepathfalse# 设置提交信息使用中文gitconfig--globali18n.commitencoding utf-8gitconfig--globali18n.logoutputencoding utf-8颜色设置让 Git 输出更美观易于阅读。# 启用颜色输出gitconfig--globalcolor.ui auto别名设置设置常用命令的别名提高工作效率。# 常用别名设置gitconfig--globalalias.st statusgitconfig--globalalias.co checkoutgitconfig--globalalias.br branchgitconfig--globalalias.ci commitgitconfig--globalalias.lglog --oneline --graph --allgitconfig--globalalias.lastlog -1 HEADgitconfig--globalalias.unstagereset HEAD --使用示例原命令使用别名git statusgit stgit checkout maingit co maingit commit -m messagegit ci -m message查看和管理配置查看所有配置# 查看所有配置gitconfig--list# 查看特定配置gitconfig user.namegitconfig user.email# 查看配置文件位置gitconfig--list--show-origin编辑配置文件# 打开全局配置文件进行编辑gitconfig--global--edit删除配置# 删除特定配置gitconfig--global--unsetuser.name配置文件位置了解配置文件的位置有助于高级管理级别文件位置说明全局配置~/.gitconfig用户级别系统配置/etc/gitconfig系统级别仓库配置.git/config仓库级别验证配置配置完成后建议验证一下# 查看所有配置gitconfig--list# 测试编辑器设置# 创建一个测试仓库mkdirtest-repocdtest-repogitinit# 创建一个文件并提交测试编辑器是否正常echotesttest.txtgitaddtest.txtgitcommit# 这时应该打开你设置的编辑器常见配置场景场景1个人开发者# 基础配置gitconfig--globaluser.nameYour Namegitconfig--globaluser.emailyour.emailexample.comgitconfig--globalcore.editorcode --waitgitconfig--globalcore.autocrlf inputgitconfig--globalinit.defaultBranch main场景2公司开发者# 使用公司邮箱和特定配置gitconfig--globaluser.nameYour Namegitconfig--globaluser.emailyour.namecompany.comgitconfig--globalcore.editorcode --waitgitconfig--globalcore.autocrlf inputgitconfig--globalinit.defaultBranch main# 可能需要配置代理gitconfig--globalhttp.proxy http://proxy.company.com:8080场景3跨平台团队# 不转换换行符保持原样gitconfig--globalcore.autocrlffalsegitconfig--globalcore.eol lf配置备份与迁移如果你需要在多台电脑上使用相同的 Git 配置# 导出配置gitconfig--global--listgitconfig.txt# 在其他电脑上导入# 可以手动编辑 ~/.gitconfig 文件# 或者使用脚本批量设置新手常见问题与建议常见问题1. 为什么我的 Git 命令不识别解决方案确保 Git 已正确安装重新打开命令行窗口检查环境变量是否包含 Git 路径2. 如何解决中文文件名显示问题# 设置 Git 正确处理中文文件名gitconfig--globalcore.quotepathfalse3. 如何查看 Git 版本git--version4. 如何获取帮助# 查看帮助文档githelp# 查看特定命令帮助githelpconfiggithelpinit新手建议学习路径建议先掌握基础命令init,add,commit,status,log理解工作区、暂存区、仓库的概念学习分支管理branch,checkout,merge了解远程仓库操作clone,pull,push最佳实践提交信息要清晰用简洁的语言描述你的更改小步提交每个提交完成一个完整的功能或修复不要提交敏感信息密码、密钥等不要提交到仓库定期备份重要项目记得推送到远程仓库避免的常见错误不要直接修改**.git**目录这是 Git 的内部文件不要忘记**git add**修改文件后需要先暂存再提交不要在错误的分支上提交先检查当前分支不要强制推送force push除非你确定你知道自己在做什么下一步学习完成安装配置后建议继续学习Git 基础命令init,add,commit,status,log分支管理branch,checkout,merge,rebase远程仓库clone,pull,push,fetch高级操作stash,cherry-pick,bisect最后更新2026年07月17日
