很多学C语言的同学来问我同一个问题我VSCode装好了、编译器能跑了为什么还要在电脑上装一个叫git的东西说实话我当初学C语言时也觉得git是工程师才用的版本管理工具离自己很远直到有一次我把练习代码改崩了想退回两小时前还能运行的版本却只能对着屏幕发呆才老老实实把git装好、配置好用到了今天。这篇就把我在C语言学习场景下安装和配置git的完整过程写出来包括每个安装选项为什么这么选、装完怎么配置、踩过的坑怎么填希望对正在搭C语言学习环境的你有帮助。1. 学C语言为什么要先解决git安装这件事1.1 你写的第一个C程序已经需要版本管理了很多人以为版本管理是大项目才需要的但学C语言的过程中代码规模虽然小迭代频率却一点也不低。你今天写一个冒泡排序调试通了运行正常明天学到函数指针想在原代码上试新写法改着改着程序崩了一晚上改不回来。如果没有git你只能凭记忆、凭CtrlZ慢慢往回找找到的还不一定对如果有git一条命令就能回到昨天那个能跑的版本。这不是个别情况而是几乎所有学C语言的人都会遇到的需求。尤其跟着翁恺老师的C语言课做练习时每一章都是在一份代码上反复迭代的我很建议从写第一个hello.c开始就把git装好哪怕你现在还不完全理解它的原理先把最基础的存档功能用起来后面学起来会省很多事。另外现在很多课程设计和实验报告的提交方式已经从交源代码文件变成了交一个git仓库地址。老师会在代码托管平台上建好作业入口要求你把实验代码推到远程仓库。如果这时候你电脑上还没有git连第一步作业提交都过不去更别说什么自动化测试、在线批改了。1.2 看开源C项目、下载教学源码git是基本入场券学C语言绕不开看别人的代码。无论是一般的OJ题库题解项目还是像Redis、SQLite这些有名的开源C项目绝大多数都托管在GitHub、Gitee之类的代码托管平台上。从这些平台拿代码最正规的方式就是git clone。只会下载zip包当然也能看代码但你会遇到几个尴尬项目原作者更新了你没办法同步你改了一版代码之后跟原版对比非常麻烦以后你想给开源项目提issue、提出修改建议没有git根本没法参与。尤其你以后进实验室、做课程设计、做毕业设计git能力几乎是个硬门槛。所以把git安装放在C语言学习的工具链第一步并不夸张。工具链是什么就是编译器、编辑器、黏合剂这些基础设施。git跟它们一样属于学C语言之前就得准备好的东西装好配置好一劳永逸。2. 下载git前需要搞明白的三件事版本、平台、安装包2.1 不用纠结最新版选当前稳定版就行git的版本更新很频繁你在搜索引擎里很容易看到各种git最新版下载的标题其实没必要追新。对C语言学习阶段来说稳定版本的功能已经远远够用你需要的是稳定可靠而不是新功能。正常下载方式很简单打开git官方下载页面Windows用户选64-bit Git for Windows Setup这个安装包下载macOS用户选对应的dmg包Linux用户直接用系统包管理器安装下文会提。判断自己系统是64位还是32位在Windows下右键此电脑→属性就能看到系统类型。现在的电脑基本都是64位的如果你实在不确定打开cmd输入 echo %PROCESSOR_ARCHITECTURE 输出AMD64就是64位。这里我要多提醒一句网上有一些第三方下载站提供高速下载看着方便但安装包可能被捆绑了其他东西或者根本不是官方原版。建议直接认准git-scm.com这个官方域名虽然下载速度不一定最快但安全有保障。2.2 Git for Windows与Git Bash到底是什么关系这是个高频疑问值得先讲清楚你安装在Windows上的那个软件全名叫Git for Windows它不是一个光秃秃的git命令而是自带了三块东西git命令本体也就是真正的版本控制工具Git Bash一个模拟Linux终端的命令行窗口里面内置了ls、cd、grep、find这些Linux常用命令Git GUI图形化的git操作界面给不想记命令的人用很多C语言初学者是在VSCode里写代码、在VSCode集成的终端里敲命令的VSCode终端默认是PowerShellPowerShell里能用git命令但当你以后学make、跑shell脚本、在服务器上部署代码时Git Bash的类Linux环境会舒服很多。所以安装时不要嫌它附带的东西太多Git Bash对后面学习编译、脚本都有帮助。2.3 macOS与Linux用户的一分钟安装说明先说macOS如果你装了Homebrew直接执行 brew install git 就行没装Homebrew就去官方下载安装包和Windows一样是图形化安装。Linux用户更简单因为git基本是各发行版的标配软件包管理器直接装# Ubuntu / Debian sudo apt install git # CentOS / RHEL / Fedora sudo yum install git # 或 sudo dnf install git装完验证 git --version 即可。macOS和Linux的命令行环境跟Windows的Git Bash高度一致所以下面讲的所有配置命令在这三个平台上几乎通用。本文后续重点讲Windows因为初学者遇到的大多数坑都集中在Windows上。3. Windows下git安装全流程每个选项都要知道为什么3.1 安装步骤总览这一步别急着无脑Next双击下载好的exe安装包会进入安装向导。界面里每一步都有对应选项如果你一路直接点Next也能把git装好但后面大概率会碰到VSCode里识别不了git命令、提交代码时CRLF换行符告警这类问题。与其到时候再折腾不如安装时就把关键选项选对。我建议的安装路径保持默认即可通常是 C:\Program Files\Git。如果你想装到D盘也完全可以注意路径不要带中文不要带空格因为后续很多开发工具在解析带中文的路径时容易出幺蛾子。其实不止git所有C语言学习相关的工具链都尽量放在纯英文路径下会比较省心。3.2 组件选择右键菜单这个功能很值到Select Components这一步默认选项基本够用但有一个地方建议注意Additional icons下面的On the Desktop就是创建桌面图标看你个人喜好。真正重要的是Windows Explorer integration下面这两项分别是Git Bash Here在文件夹右键菜单里增加一个入口点一下就直接在这个目录打开Git BashGit GUI Here在文件夹右键菜单里增加图形化git入口这两项建议保持勾选。Git Bash Here几乎是我日常使用频率最高的入口打开资源管理器定位到某个C语言项目目录右键选Git Bash Here终端直接在项目目录就位省去了cd来回切换的麻烦。对命令行还不熟悉的初学者来说这个功能能帮你少记很多路径切换的命令。3.3 默认编辑器直接选VSCode别让Vim坑了你安装过程中会让你选Default editor used by Git这个编辑器在什么场景下会被用到比如你执行 git commit 时不带 -m 参数git会弹出一个编辑器让你填写提交信息比如某些需要输入多行说明的场合。新装系统如果没装其他编辑器默认值只会是Vim。问题来了Vim对初学者来说太难了。你在Git Bash里被带进Vim界面后发现鼠标点不了、字打不进去想退出又不知道该按什么键卡在commit界面最后只能关窗口。这就是我在一开始说的装完之后查一晚上资料的重要来源之一。如果你平时用VSCode写C语言建议在这里从下拉列表选择Use Visual Studio Code as Gits default editor选项。如果在列表里没看到VSCode可能是你装的VSCode版本太旧或者安装时没勾选添加到系统PATH去重新安装一遍VSCode时勾上那个选项再重跑一次git安装程序这步就能识别到了。装好之后git需要编辑时就会自动打开VSCode熟悉感一下就上来了。3.4 PATH环境变量初学者这里选错麻烦最多Adjusting your PATH environment这一步是三个单选含义如下选项含义适用场景Use Git from Git Bash onlygit命令只在Git Bash里可用CMD和PowerShell里都识别不了只打算在Git Bash里用命令行Git from the command line and also from 3rd-party software把git加入系统PATHCMD、PowerShell、VSCode都能调git命令推荐VSCode终端直接用git很方便Use Git and optional Unix tools from the Command Prompt除git外还把一批Linux命令也加入全局PATH不推荐命令容易和Windows自带命令冲突很多C语言初学者是在VSCode里写代码、在VSCode终端里直接敲git命令的所以从实际使用出发建议选第二个选项Git from the command line and also from 3rd-party software。为什么这一步如此关键因为VSCode、SourceTree这类图形化工具要调用git时本质上是去系统PATH里找git.exe。你选了第一个选项git命令只存在于Git Bash内部VSCode终端里输入git系统根本不知道这个命令在哪于是就会报告无法将git项识别为cmdlet、函数、脚本文件或可运行程序的名称。我在后面第六部分还会专门讲这个报错这里先记住选第二个。3.5 换行符转换CRLF与LF的坑现在知道比以后知道好Line Ending Conversions这一步默认选项是Checkout Windows-style, commit Unix-style line endings很多教程会直接让你保持默认。我的建议是在C语言学习阶段可以先保持默认但你要清楚它是干什么的。Windows里文本文件默认用CRLF回车换行表示一行结束Linux/macOS默认用LF换行。这个选项的意思是从仓库检出代码到本地时git自动把内容转成Windows的CRLF你提交的时候再自动转回LF存进仓库。这样Windows下的编辑器打开文件一切正常仓库里又保持了Linux风格的一致性。好处有了坏处呢当你以后和Linux环境协作、或者接手一份需要LF结尾的shell脚本时默认选项可能让脚本看起来内容完全正确但一运行就报错原因就是换行符不对。遇到这种情况再改成Checkout as-is, commit as-is也不迟。总之先知道这个机制遇到相关问题时你就不会觉得git在捣乱了。3.6 终端模拟器、pull行为与凭据管理器后面几步的默认选项一般保持默认就好但需要知道它们各自管什么Use MinTTY这是Git Bash使用的终端模拟器比Windows老式控制台窗口体验好很多保持默认即可Default pull behavior默认的git pull行为策略当前学习阶段保持默认就好不深究Credential Manager凭据管理器建议保持默认的Git Credential Manager。这个工具能在你第一次push代码到远程仓库时弹出登录窗口并把凭据安全保存下来省得以后每次操作都要输密码安装进度条走完后最后一步会出现完成界面取消勾选View Release Notes后点Finish即可。这里有一个小提醒安装完成后如果你之前已经打开了一个终端窗口要先把它全部关掉再新开一个CMD或PowerShell窗口然后执行 git --version。因为旧窗口读不到新配置的环境变量直接敲git会提示找不到命令别误以为安装失败了。能看到类似 git version 2.4x.x.windows.1 的输出就是安装成功。4. 装完git之后先做这4个基础配置再开始写代码4.1 user.name与user.email每次提交都需要的签名git每次提交代码时都必须记录谁在什么时间提交了什么内容。如果user.name和user.email没配置第一次执行git commit时git会直接报错请你先设置身份信息。从头到尾自己手动配一次比你哪天被报错逼着去查资料要好得多。打开Git Bash或PowerShell逐行执行git config --global user.name Your Name git config --global user.email youexample.com把引号里的内容换成你自己的名字和邮箱。名字建议用拼音或英文昵称邮箱建议用你以后注册GitHub或Gitee时用的账号邮箱这样以后推送到远程仓库提交记录的身份能对得上。用 --global 的意思是全局生效也就是说这台机器上所有git仓库都默认使用这个身份信息省得每个仓库单独配。想查看当前哪些配置已生效随时可以执行 git config --list。4.2 设置默认分支名master还是main先统一git新版本里本地新建仓库的默认分支名曾经一直叫master但GitHub等平台已经把新建仓库的默认分支改成了main。为了你本地 git init 出来的仓库和远程仓库保持一致少一些两个分支并存造成困惑的情况建议顺手执行git config --global init.defaultBranch main这句命令的意思是以后在你本地执行 git init 时自动创建main分支而不是master。它不会影响已有的仓库。如果你跟着的课程要求用master当然也可以不设置最重要的是心里清楚分支名只是个名字前后一致就好。4.3 配置默认编辑器把git的编辑器从Vim改成VSCode如果你在安装git那一步没有选VSCode作为默认编辑器安装完成之后还是有机会补救的。执行这条命令把git调用的编辑器改成VSCodegit config --global core.editor code --wait这里的 code 是VSCode在命令行里的启动命令--wait 表示git会等你编辑完文件关闭窗口后继续执行。如果你用的是其他编辑器也可以填对应的命令比如 Notepad 或 Sublime Text 都可以但C语言学习阶段最顺手的还是VSCode毕竟你已经在用它写代码了。4.4 针对C语言项目的.gitignore一点小配置省很多事.gitignore是git项目里的一个特殊文本文件用来告诉git哪些文件不要纳入版本管理我不需要关心它们的变化。对C语言项目来说下面这份常见的配置建议在创建项目根目录时就放一份# 编译产生的目标文件和可执行文件 *.o *.exe *.out *.obj # 编译器生成的临时文件 *.pdb *.ilk .vscode/ # 系统文件 .DS_Store Thumbs.db为什么要把 .o、.exe 这些文件忽略因为编译产物是从源码可重复生成的你提交它们进仓库不仅让仓库越来越大而且不同的编译环境、不同的操作系统生成出来的二进制文件还不一样别人拿到这些文件没有任何意义。版本管理系统最合理的使用模型是只管理原料源代码不管理成品编译结果。以后你每次编译C语言项目生成的.o和.exe文件都不会在git status里冒出来捣乱提交记录会干净很多。创建方法很简单在项目根目录新建一个文本文件命名为 .gitignore注意文件名以点开头在Windows资源管理器里可能提示你输入文件名直接输入.gitignore并回车即可把上面的内容粘贴保存。VSCode会自动识别它的语法高亮。5. 第一次用git管理你的C语言代码完整走一遍流程5.1 初始化仓库让git盯上这个目录假设你已经创建了一个目录比如 D:\code\c-learning里面放了第一个C语言练习文件现在想让它进入git管理。在Git Bash里先切换到这个目录然后初始化仓库cd /d/code/c-learning git init执行 git init 后当前目录会生成一个名为 .git 的隐藏文件夹。这个文件夹是git的核心账本记录着每次提交的历史、分支信息、各种配置。理解git的一个关键认知是git管理的不是文件而是状态。你每提交一次git就为整个项目拍一张快照之后可以在任意一张快照之间来回跳转。接着执行 git status 看看当前状态git status输出会告诉你当前在哪个分支比如main取决于你第4.2里的配置以及有哪些文件还没被跟踪untracked files。未跟踪的文件通常是绿色的意思是git知道这个文件存在但按你的指示它还没有开始管理这个文件。5.2 暂存区是什么add与commit为什么要分两步git的提交分两步这个问题刚接触时很多人理解不了我改了文件为什么不直接保存成一次提交还要先 git add 再 git commit其实这两步的分工完全不同。你可以把暂存区staging area想象成一个快递打包台。你要寄几个包裹先把挑出来要寄的东西放上打包台git add确认这次要寄的就是这些然后统一填单发出git commit。好处是灵活你同时改了好几个文件但这次只想把这一个文件的改动提交成一条记录另一个文件留到下次再说完全由你控制。比如你同时改了hello.c和read_file.c但这次的提交只希望包含hello.c的改动git add hello.c git commit -m 完成冒泡排序的C语言实现如果你想一次性把所有改动都加入暂存区可以直接用 git add -A 或 git add .。但对初学者我建议多用指定具体文件的方式这样你心里清楚每次提交到底包含哪些改动也避免不小心把临时文件带进提交。5.3 一次完整的提交闭环从写代码到查历史下面用一个最简单的例子把整个流程走通在项目目录里新建 hello.c内容随意比如#include stdio.h int main(void) { printf(Hello, Git!\n); return 0; }执行 git status你会看到 hello.c 显示为未跟踪状态。执行 git add hello.c再次 git status文件名会变成代表已暂存的颜色并且标注为 new file。执行 git commit -m 我的第一个C程序。执行 git log --oneline会看到一行提交记录类似 abc1234 我的第一个C程序。这个闭环——改代码、add、commit、log——就是你以后每次写代码的基本节奏。代码量小的时候你可能感觉不到什么但一旦开始做课程设计几十个文件改来改去每次commit对应哪个功能回退起来是真的快。想体验回到过去的话随便改一下hello.c加上一行没用的代码然后执行 git checkout -- hello.c文件就会恢复到最后一次提交时的内容。这个命令在练习阶段完全够用等以后学到分支还有更灵活的操作方式。5.4 提交信息怎么写才不后悔commit信息是写给未来的自己看的。我刚学git时习惯写更新两个字过了两个星期再翻log完全想不起来那个版本到底改了什么。后来养成了一个习惯用简短的句子描述本次提交解决的问题并且尽量跟具体功能挂钩。不要写update、修改、test尽量写实现单链表插入节点函数、修复数组越界导致的段错误、重构第三章练习的排序测试代码这样做之后git log --oneline 一列出来整条学习路径就非常清晰甚至可以把日志当成代码日记用。课程设计交作业时老师让你解释项目开发过程你翻一遍提交记录就能完整复述这本身就是加分项。6. 这几个装上之后才遇到的坑我替你趟过了6.1 在PowerShell里输入git提示无法识别这个报错在所有git相关热词里排前面几乎每个学C语言的同学都会撞上一次。报错信息一般是git : 无法将“git”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。原因通常只有一个安装git时PATH环境变量的选项没选对或者选对了但当前终端窗口是安装之前打开的没读到新配置的环境变量。排查步骤新开一个PowerShell窗口注意是新开不是用之前的旧窗口执行 git --version如果新窗口能正常显示版本号说明只是旧窗口环境变量过期。重启VSCode或重新开终端就好如果新窗口里还是无法识别说明PATH确实没配好。这时候打开系统的环境变量设置界面在Path里手动添加git安装目录下的cmd路径通常是 C:\Program Files\Git\cmd保存后关掉所有窗口重开一次问题就解决了我见过有人在这个问题上折腾一下午最后发现只是没重开终端。如果你也卡了很久先试试所有窗口全部关闭再重新打开这一步成本最低。6.2 执行git命令提示 fatal: not a git repository这个报错也很常见报错信息是fatal: not a git repository (or any of the parent directories): .git意思是当前目录不是一个git仓库往上找也没找到.git文件夹。因为你在这个目录执行了 git log、git commit 这类需要仓库才能操作的命令但git根本没有任何历史记录可查。解决办法分两种如果你确实想在这个目录里使用git管理代码执行 git init 初始化仓库如果你敲命令时站错位置了用 cd 命令切换到已经初始化过的项目目录再去执行。很多C语言初学者报这个错是在VSCode里打开了一个已经存在的文件夹但那个文件夹从来没有被git管理过所以少了一步 git init。先初始化再继续操作报错就会消失。6.3 VSCode里出现 no tracked commits 或一直转圈在VSCode的源代码管理面板里如果刚打开一个git仓库有时候会出现类似The repository at ... has no tracked commits yet的红色提示。看着像错误其实它只是告诉你仓库里还没产生任何提交记录。这是正常的初始状态。你只要按第五部分的操作完成第一次 git add 和 git commit这个提示就会变成正常的空状态。如果你折腾了很久怎么都提交不上去VSCode的源代码管理面板一直显示正在初始化或者转圈那通常跟远程仓库登录、Git扩展插件配置有关不影响本地使用git。先把本地的 add、commit 流程跑通远程推送的问题可以等后边学习到GitHub/Gitee时再集中处理。6.4 提交时出现CRLF/LF换行符警告在Windows上使用git时第一次 git add 文件常会看到这样的警告warning: LF will be replaced by CRLF in xxx.c。这不是错误恰恰相反它是在提醒你插入文本的换行符格式会被git自动转换。这个警告的出现与我在第3.5节里说的换行符转换设置直接相关。如果你的C语言学习完全在Windows下进行也不打算和Linux环境协作保持默认设置没问题这个警告可以忽略。如果你不喜欢它频繁出现可以在项目或全局执行git config core.autocrlf true把自动转换配置明确打开后警告频次会降低。真正需要留意的是当你把一个在Windows下提交过的脚本文件拿到Linux服务器上运行发现执行报错、提示找不到命令之类的问题时多半就是换行符在捣乱到时候把文件转成LF结尾即可这个属于后面进阶内容了。6.5 第一次push远程仓库时的token与凭据问题学到后面你会想把本地代码推到GitHub或Gitee的远程仓库。第一次push时git会弹出登录窗口让你填用户名和密码。这里不少初学者会被Login failed. Check API token or GitLab version之类的报错卡住。这个报错通常和git本身关系不大而是托管平台现在普遍要求用个人访问令牌Personal Access Token来代替账号密码。你需要在平台的设置里找到开发者设置或访问令牌生成一个token复制后粘贴到弹出的登录窗口里。凭据管理器会自动保存它之后push就不会再反复要密码了。把这一点记住以后第一次连远程仓库会少走好多弯路。就我个人的实际体验来说git对C语言初学者最大的门槛不是命令本身而是为什么要装、装的时候怎么选、装了之后怎么配置这三件事。这篇基本就是按这个顺序展开的把这一环补上之后你可以没有任何负担地先把git用起来。等代码量上来、开始做课程设计时你会感谢那个一开始就把基础配置做好的自己。
很多学C语言的同学来问我同一个问题我VSCode装好了、编译器能跑了为什么还要在电脑上装一个叫git的东西说实话我当初学C语言时也觉得git是工程师才用的版本管理工具离自己很远直到有一次我把练习代码改崩了想退回两小时前还能运行的版本却只能对着屏幕发呆才老老实实把git装好、配置好用到了今天。这篇就把我在C语言学习场景下安装和配置git的完整过程写出来包括每个安装选项为什么这么选、装完怎么配置、踩过的坑怎么填希望对正在搭C语言学习环境的你有帮助。1. 学C语言为什么要先解决git安装这件事1.1 你写的第一个C程序已经需要版本管理了很多人以为版本管理是大项目才需要的但学C语言的过程中代码规模虽然小迭代频率却一点也不低。你今天写一个冒泡排序调试通了运行正常明天学到函数指针想在原代码上试新写法改着改着程序崩了一晚上改不回来。如果没有git你只能凭记忆、凭CtrlZ慢慢往回找找到的还不一定对如果有git一条命令就能回到昨天那个能跑的版本。这不是个别情况而是几乎所有学C语言的人都会遇到的需求。尤其跟着翁恺老师的C语言课做练习时每一章都是在一份代码上反复迭代的我很建议从写第一个hello.c开始就把git装好哪怕你现在还不完全理解它的原理先把最基础的存档功能用起来后面学起来会省很多事。另外现在很多课程设计和实验报告的提交方式已经从交源代码文件变成了交一个git仓库地址。老师会在代码托管平台上建好作业入口要求你把实验代码推到远程仓库。如果这时候你电脑上还没有git连第一步作业提交都过不去更别说什么自动化测试、在线批改了。1.2 看开源C项目、下载教学源码git是基本入场券学C语言绕不开看别人的代码。无论是一般的OJ题库题解项目还是像Redis、SQLite这些有名的开源C项目绝大多数都托管在GitHub、Gitee之类的代码托管平台上。从这些平台拿代码最正规的方式就是git clone。只会下载zip包当然也能看代码但你会遇到几个尴尬项目原作者更新了你没办法同步你改了一版代码之后跟原版对比非常麻烦以后你想给开源项目提issue、提出修改建议没有git根本没法参与。尤其你以后进实验室、做课程设计、做毕业设计git能力几乎是个硬门槛。所以把git安装放在C语言学习的工具链第一步并不夸张。工具链是什么就是编译器、编辑器、黏合剂这些基础设施。git跟它们一样属于学C语言之前就得准备好的东西装好配置好一劳永逸。2. 下载git前需要搞明白的三件事版本、平台、安装包2.1 不用纠结最新版选当前稳定版就行git的版本更新很频繁你在搜索引擎里很容易看到各种git最新版下载的标题其实没必要追新。对C语言学习阶段来说稳定版本的功能已经远远够用你需要的是稳定可靠而不是新功能。正常下载方式很简单打开git官方下载页面Windows用户选64-bit Git for Windows Setup这个安装包下载macOS用户选对应的dmg包Linux用户直接用系统包管理器安装下文会提。判断自己系统是64位还是32位在Windows下右键此电脑→属性就能看到系统类型。现在的电脑基本都是64位的如果你实在不确定打开cmd输入 echo %PROCESSOR_ARCHITECTURE 输出AMD64就是64位。这里我要多提醒一句网上有一些第三方下载站提供高速下载看着方便但安装包可能被捆绑了其他东西或者根本不是官方原版。建议直接认准git-scm.com这个官方域名虽然下载速度不一定最快但安全有保障。2.2 Git for Windows与Git Bash到底是什么关系这是个高频疑问值得先讲清楚你安装在Windows上的那个软件全名叫Git for Windows它不是一个光秃秃的git命令而是自带了三块东西git命令本体也就是真正的版本控制工具Git Bash一个模拟Linux终端的命令行窗口里面内置了ls、cd、grep、find这些Linux常用命令Git GUI图形化的git操作界面给不想记命令的人用很多C语言初学者是在VSCode里写代码、在VSCode集成的终端里敲命令的VSCode终端默认是PowerShellPowerShell里能用git命令但当你以后学make、跑shell脚本、在服务器上部署代码时Git Bash的类Linux环境会舒服很多。所以安装时不要嫌它附带的东西太多Git Bash对后面学习编译、脚本都有帮助。2.3 macOS与Linux用户的一分钟安装说明先说macOS如果你装了Homebrew直接执行 brew install git 就行没装Homebrew就去官方下载安装包和Windows一样是图形化安装。Linux用户更简单因为git基本是各发行版的标配软件包管理器直接装# Ubuntu / Debian sudo apt install git # CentOS / RHEL / Fedora sudo yum install git # 或 sudo dnf install git装完验证 git --version 即可。macOS和Linux的命令行环境跟Windows的Git Bash高度一致所以下面讲的所有配置命令在这三个平台上几乎通用。本文后续重点讲Windows因为初学者遇到的大多数坑都集中在Windows上。3. Windows下git安装全流程每个选项都要知道为什么3.1 安装步骤总览这一步别急着无脑Next双击下载好的exe安装包会进入安装向导。界面里每一步都有对应选项如果你一路直接点Next也能把git装好但后面大概率会碰到VSCode里识别不了git命令、提交代码时CRLF换行符告警这类问题。与其到时候再折腾不如安装时就把关键选项选对。我建议的安装路径保持默认即可通常是 C:\Program Files\Git。如果你想装到D盘也完全可以注意路径不要带中文不要带空格因为后续很多开发工具在解析带中文的路径时容易出幺蛾子。其实不止git所有C语言学习相关的工具链都尽量放在纯英文路径下会比较省心。3.2 组件选择右键菜单这个功能很值到Select Components这一步默认选项基本够用但有一个地方建议注意Additional icons下面的On the Desktop就是创建桌面图标看你个人喜好。真正重要的是Windows Explorer integration下面这两项分别是Git Bash Here在文件夹右键菜单里增加一个入口点一下就直接在这个目录打开Git BashGit GUI Here在文件夹右键菜单里增加图形化git入口这两项建议保持勾选。Git Bash Here几乎是我日常使用频率最高的入口打开资源管理器定位到某个C语言项目目录右键选Git Bash Here终端直接在项目目录就位省去了cd来回切换的麻烦。对命令行还不熟悉的初学者来说这个功能能帮你少记很多路径切换的命令。3.3 默认编辑器直接选VSCode别让Vim坑了你安装过程中会让你选Default editor used by Git这个编辑器在什么场景下会被用到比如你执行 git commit 时不带 -m 参数git会弹出一个编辑器让你填写提交信息比如某些需要输入多行说明的场合。新装系统如果没装其他编辑器默认值只会是Vim。问题来了Vim对初学者来说太难了。你在Git Bash里被带进Vim界面后发现鼠标点不了、字打不进去想退出又不知道该按什么键卡在commit界面最后只能关窗口。这就是我在一开始说的装完之后查一晚上资料的重要来源之一。如果你平时用VSCode写C语言建议在这里从下拉列表选择Use Visual Studio Code as Gits default editor选项。如果在列表里没看到VSCode可能是你装的VSCode版本太旧或者安装时没勾选添加到系统PATH去重新安装一遍VSCode时勾上那个选项再重跑一次git安装程序这步就能识别到了。装好之后git需要编辑时就会自动打开VSCode熟悉感一下就上来了。3.4 PATH环境变量初学者这里选错麻烦最多Adjusting your PATH environment这一步是三个单选含义如下选项含义适用场景Use Git from Git Bash onlygit命令只在Git Bash里可用CMD和PowerShell里都识别不了只打算在Git Bash里用命令行Git from the command line and also from 3rd-party software把git加入系统PATHCMD、PowerShell、VSCode都能调git命令推荐VSCode终端直接用git很方便Use Git and optional Unix tools from the Command Prompt除git外还把一批Linux命令也加入全局PATH不推荐命令容易和Windows自带命令冲突很多C语言初学者是在VSCode里写代码、在VSCode终端里直接敲git命令的所以从实际使用出发建议选第二个选项Git from the command line and also from 3rd-party software。为什么这一步如此关键因为VSCode、SourceTree这类图形化工具要调用git时本质上是去系统PATH里找git.exe。你选了第一个选项git命令只存在于Git Bash内部VSCode终端里输入git系统根本不知道这个命令在哪于是就会报告无法将git项识别为cmdlet、函数、脚本文件或可运行程序的名称。我在后面第六部分还会专门讲这个报错这里先记住选第二个。3.5 换行符转换CRLF与LF的坑现在知道比以后知道好Line Ending Conversions这一步默认选项是Checkout Windows-style, commit Unix-style line endings很多教程会直接让你保持默认。我的建议是在C语言学习阶段可以先保持默认但你要清楚它是干什么的。Windows里文本文件默认用CRLF回车换行表示一行结束Linux/macOS默认用LF换行。这个选项的意思是从仓库检出代码到本地时git自动把内容转成Windows的CRLF你提交的时候再自动转回LF存进仓库。这样Windows下的编辑器打开文件一切正常仓库里又保持了Linux风格的一致性。好处有了坏处呢当你以后和Linux环境协作、或者接手一份需要LF结尾的shell脚本时默认选项可能让脚本看起来内容完全正确但一运行就报错原因就是换行符不对。遇到这种情况再改成Checkout as-is, commit as-is也不迟。总之先知道这个机制遇到相关问题时你就不会觉得git在捣乱了。3.6 终端模拟器、pull行为与凭据管理器后面几步的默认选项一般保持默认就好但需要知道它们各自管什么Use MinTTY这是Git Bash使用的终端模拟器比Windows老式控制台窗口体验好很多保持默认即可Default pull behavior默认的git pull行为策略当前学习阶段保持默认就好不深究Credential Manager凭据管理器建议保持默认的Git Credential Manager。这个工具能在你第一次push代码到远程仓库时弹出登录窗口并把凭据安全保存下来省得以后每次操作都要输密码安装进度条走完后最后一步会出现完成界面取消勾选View Release Notes后点Finish即可。这里有一个小提醒安装完成后如果你之前已经打开了一个终端窗口要先把它全部关掉再新开一个CMD或PowerShell窗口然后执行 git --version。因为旧窗口读不到新配置的环境变量直接敲git会提示找不到命令别误以为安装失败了。能看到类似 git version 2.4x.x.windows.1 的输出就是安装成功。4. 装完git之后先做这4个基础配置再开始写代码4.1 user.name与user.email每次提交都需要的签名git每次提交代码时都必须记录谁在什么时间提交了什么内容。如果user.name和user.email没配置第一次执行git commit时git会直接报错请你先设置身份信息。从头到尾自己手动配一次比你哪天被报错逼着去查资料要好得多。打开Git Bash或PowerShell逐行执行git config --global user.name Your Name git config --global user.email youexample.com把引号里的内容换成你自己的名字和邮箱。名字建议用拼音或英文昵称邮箱建议用你以后注册GitHub或Gitee时用的账号邮箱这样以后推送到远程仓库提交记录的身份能对得上。用 --global 的意思是全局生效也就是说这台机器上所有git仓库都默认使用这个身份信息省得每个仓库单独配。想查看当前哪些配置已生效随时可以执行 git config --list。4.2 设置默认分支名master还是main先统一git新版本里本地新建仓库的默认分支名曾经一直叫master但GitHub等平台已经把新建仓库的默认分支改成了main。为了你本地 git init 出来的仓库和远程仓库保持一致少一些两个分支并存造成困惑的情况建议顺手执行git config --global init.defaultBranch main这句命令的意思是以后在你本地执行 git init 时自动创建main分支而不是master。它不会影响已有的仓库。如果你跟着的课程要求用master当然也可以不设置最重要的是心里清楚分支名只是个名字前后一致就好。4.3 配置默认编辑器把git的编辑器从Vim改成VSCode如果你在安装git那一步没有选VSCode作为默认编辑器安装完成之后还是有机会补救的。执行这条命令把git调用的编辑器改成VSCodegit config --global core.editor code --wait这里的 code 是VSCode在命令行里的启动命令--wait 表示git会等你编辑完文件关闭窗口后继续执行。如果你用的是其他编辑器也可以填对应的命令比如 Notepad 或 Sublime Text 都可以但C语言学习阶段最顺手的还是VSCode毕竟你已经在用它写代码了。4.4 针对C语言项目的.gitignore一点小配置省很多事.gitignore是git项目里的一个特殊文本文件用来告诉git哪些文件不要纳入版本管理我不需要关心它们的变化。对C语言项目来说下面这份常见的配置建议在创建项目根目录时就放一份# 编译产生的目标文件和可执行文件 *.o *.exe *.out *.obj # 编译器生成的临时文件 *.pdb *.ilk .vscode/ # 系统文件 .DS_Store Thumbs.db为什么要把 .o、.exe 这些文件忽略因为编译产物是从源码可重复生成的你提交它们进仓库不仅让仓库越来越大而且不同的编译环境、不同的操作系统生成出来的二进制文件还不一样别人拿到这些文件没有任何意义。版本管理系统最合理的使用模型是只管理原料源代码不管理成品编译结果。以后你每次编译C语言项目生成的.o和.exe文件都不会在git status里冒出来捣乱提交记录会干净很多。创建方法很简单在项目根目录新建一个文本文件命名为 .gitignore注意文件名以点开头在Windows资源管理器里可能提示你输入文件名直接输入.gitignore并回车即可把上面的内容粘贴保存。VSCode会自动识别它的语法高亮。5. 第一次用git管理你的C语言代码完整走一遍流程5.1 初始化仓库让git盯上这个目录假设你已经创建了一个目录比如 D:\code\c-learning里面放了第一个C语言练习文件现在想让它进入git管理。在Git Bash里先切换到这个目录然后初始化仓库cd /d/code/c-learning git init执行 git init 后当前目录会生成一个名为 .git 的隐藏文件夹。这个文件夹是git的核心账本记录着每次提交的历史、分支信息、各种配置。理解git的一个关键认知是git管理的不是文件而是状态。你每提交一次git就为整个项目拍一张快照之后可以在任意一张快照之间来回跳转。接着执行 git status 看看当前状态git status输出会告诉你当前在哪个分支比如main取决于你第4.2里的配置以及有哪些文件还没被跟踪untracked files。未跟踪的文件通常是绿色的意思是git知道这个文件存在但按你的指示它还没有开始管理这个文件。5.2 暂存区是什么add与commit为什么要分两步git的提交分两步这个问题刚接触时很多人理解不了我改了文件为什么不直接保存成一次提交还要先 git add 再 git commit其实这两步的分工完全不同。你可以把暂存区staging area想象成一个快递打包台。你要寄几个包裹先把挑出来要寄的东西放上打包台git add确认这次要寄的就是这些然后统一填单发出git commit。好处是灵活你同时改了好几个文件但这次只想把这一个文件的改动提交成一条记录另一个文件留到下次再说完全由你控制。比如你同时改了hello.c和read_file.c但这次的提交只希望包含hello.c的改动git add hello.c git commit -m 完成冒泡排序的C语言实现如果你想一次性把所有改动都加入暂存区可以直接用 git add -A 或 git add .。但对初学者我建议多用指定具体文件的方式这样你心里清楚每次提交到底包含哪些改动也避免不小心把临时文件带进提交。5.3 一次完整的提交闭环从写代码到查历史下面用一个最简单的例子把整个流程走通在项目目录里新建 hello.c内容随意比如#include stdio.h int main(void) { printf(Hello, Git!\n); return 0; }执行 git status你会看到 hello.c 显示为未跟踪状态。执行 git add hello.c再次 git status文件名会变成代表已暂存的颜色并且标注为 new file。执行 git commit -m 我的第一个C程序。执行 git log --oneline会看到一行提交记录类似 abc1234 我的第一个C程序。这个闭环——改代码、add、commit、log——就是你以后每次写代码的基本节奏。代码量小的时候你可能感觉不到什么但一旦开始做课程设计几十个文件改来改去每次commit对应哪个功能回退起来是真的快。想体验回到过去的话随便改一下hello.c加上一行没用的代码然后执行 git checkout -- hello.c文件就会恢复到最后一次提交时的内容。这个命令在练习阶段完全够用等以后学到分支还有更灵活的操作方式。5.4 提交信息怎么写才不后悔commit信息是写给未来的自己看的。我刚学git时习惯写更新两个字过了两个星期再翻log完全想不起来那个版本到底改了什么。后来养成了一个习惯用简短的句子描述本次提交解决的问题并且尽量跟具体功能挂钩。不要写update、修改、test尽量写实现单链表插入节点函数、修复数组越界导致的段错误、重构第三章练习的排序测试代码这样做之后git log --oneline 一列出来整条学习路径就非常清晰甚至可以把日志当成代码日记用。课程设计交作业时老师让你解释项目开发过程你翻一遍提交记录就能完整复述这本身就是加分项。6. 这几个装上之后才遇到的坑我替你趟过了6.1 在PowerShell里输入git提示无法识别这个报错在所有git相关热词里排前面几乎每个学C语言的同学都会撞上一次。报错信息一般是git : 无法将“git”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。原因通常只有一个安装git时PATH环境变量的选项没选对或者选对了但当前终端窗口是安装之前打开的没读到新配置的环境变量。排查步骤新开一个PowerShell窗口注意是新开不是用之前的旧窗口执行 git --version如果新窗口能正常显示版本号说明只是旧窗口环境变量过期。重启VSCode或重新开终端就好如果新窗口里还是无法识别说明PATH确实没配好。这时候打开系统的环境变量设置界面在Path里手动添加git安装目录下的cmd路径通常是 C:\Program Files\Git\cmd保存后关掉所有窗口重开一次问题就解决了我见过有人在这个问题上折腾一下午最后发现只是没重开终端。如果你也卡了很久先试试所有窗口全部关闭再重新打开这一步成本最低。6.2 执行git命令提示 fatal: not a git repository这个报错也很常见报错信息是fatal: not a git repository (or any of the parent directories): .git意思是当前目录不是一个git仓库往上找也没找到.git文件夹。因为你在这个目录执行了 git log、git commit 这类需要仓库才能操作的命令但git根本没有任何历史记录可查。解决办法分两种如果你确实想在这个目录里使用git管理代码执行 git init 初始化仓库如果你敲命令时站错位置了用 cd 命令切换到已经初始化过的项目目录再去执行。很多C语言初学者报这个错是在VSCode里打开了一个已经存在的文件夹但那个文件夹从来没有被git管理过所以少了一步 git init。先初始化再继续操作报错就会消失。6.3 VSCode里出现 no tracked commits 或一直转圈在VSCode的源代码管理面板里如果刚打开一个git仓库有时候会出现类似The repository at ... has no tracked commits yet的红色提示。看着像错误其实它只是告诉你仓库里还没产生任何提交记录。这是正常的初始状态。你只要按第五部分的操作完成第一次 git add 和 git commit这个提示就会变成正常的空状态。如果你折腾了很久怎么都提交不上去VSCode的源代码管理面板一直显示正在初始化或者转圈那通常跟远程仓库登录、Git扩展插件配置有关不影响本地使用git。先把本地的 add、commit 流程跑通远程推送的问题可以等后边学习到GitHub/Gitee时再集中处理。6.4 提交时出现CRLF/LF换行符警告在Windows上使用git时第一次 git add 文件常会看到这样的警告warning: LF will be replaced by CRLF in xxx.c。这不是错误恰恰相反它是在提醒你插入文本的换行符格式会被git自动转换。这个警告的出现与我在第3.5节里说的换行符转换设置直接相关。如果你的C语言学习完全在Windows下进行也不打算和Linux环境协作保持默认设置没问题这个警告可以忽略。如果你不喜欢它频繁出现可以在项目或全局执行git config core.autocrlf true把自动转换配置明确打开后警告频次会降低。真正需要留意的是当你把一个在Windows下提交过的脚本文件拿到Linux服务器上运行发现执行报错、提示找不到命令之类的问题时多半就是换行符在捣乱到时候把文件转成LF结尾即可这个属于后面进阶内容了。6.5 第一次push远程仓库时的token与凭据问题学到后面你会想把本地代码推到GitHub或Gitee的远程仓库。第一次push时git会弹出登录窗口让你填用户名和密码。这里不少初学者会被Login failed. Check API token or GitLab version之类的报错卡住。这个报错通常和git本身关系不大而是托管平台现在普遍要求用个人访问令牌Personal Access Token来代替账号密码。你需要在平台的设置里找到开发者设置或访问令牌生成一个token复制后粘贴到弹出的登录窗口里。凭据管理器会自动保存它之后push就不会再反复要密码了。把这一点记住以后第一次连远程仓库会少走好多弯路。就我个人的实际体验来说git对C语言初学者最大的门槛不是命令本身而是为什么要装、装的时候怎么选、装了之后怎么配置这三件事。这篇基本就是按这个顺序展开的把这一环补上之后你可以没有任何负担地先把git用起来。等代码量上来、开始做课程设计时你会感谢那个一开始就把基础配置做好的自己。
