★ FEATURED ARTICLE 1. 从零搞懂Git为什么你的作业提交总出问题很多刚开始接触编程作业的同学第一次听到“用Git提交作业”这句话时脑子里冒出来的问题往往不是“Git是什么”而是“我代码写完了直接发给老师不就行了吗为什么还要多此一举”。我刚开始带项目的时候也这么想过直到有一次同时收了三十多份命名五花八门的压缩包解压之后发现有人把整个虚拟环境都打包进来了有人改了代码但没留任何记录出了问题根本不知道是谁在哪个环节改坏的。从那时候起我才真正理解Git解决的不是“存文件”的问题而是“管理文件变化过程”的问题。这篇文章面向的是刚学Python、第一次被要求用Git交作业的朋友也适合那些用过Git但只会git add和git commit两条命令、对背后发生了什么完全没概念的人。我会把Git的几个核心阶段讲透然后手把手带你走一遍从写代码到提交作业的完整流程最后把我踩过的坑和常见报错整理成一张速查表。你不需要任何前置知识只要会敲命令行就行。核心关键词我先摆在这里工作区、暂存区、本地仓库、远程仓库、提交、分支。这几个词你只要理解了Git基本就通了。很多人觉得Git难其实难的不是命令而是没搞清楚“文件到底在哪个阶段”。就像寄快递你得先打包工作区再放到快递点暂存区快递员取走存进仓库本地仓库最后发到收件城市远程仓库。每一步文件的状态都不一样搞混了就会出各种莫名其妙的错。我见过太多同学代码写完了直接git push结果报错说没有东西可以推送然后就开始慌。其实问题特别简单——你还没提交呢仓库里根本没有新东西拿什么推。这类问题的根源都是对Git的阶段划分没有建立直观认识。所以下面我先不讲命令先把这几个阶段掰开揉碎讲清楚。2. Git四大阶段全解析文件到底经历了什么2.1 工作区你真正动手改代码的地方工作区就是你电脑上能看到的那个项目文件夹里面有你写的.py文件、README、数据文件等等。你在这个文件夹里新建、修改、删除文件这些操作都发生在工作区。关键点在于工作区里的改动Git默认是不管的。你新建了一个homework.pyGit不会自动记录它你得主动告诉Git“这个文件我要纳入管理”。这里有个特别容易踩的坑。很多同学在项目文件夹里放了一堆临时文件比如__pycache__文件夹、.idea配置、测试用的test.txt然后一股脑全提交上去。结果老师打开一看一堆没用的东西。正确的做法是在项目根目录建一个.gitignore文件把不需要提交的东西写进去。比如Python项目常见的__pycache__/ *.pyc .idea/ .vscode/ *.log这个文件本身是要提交的因为它告诉Git哪些东西该忽略。我一般建议在git init之后第一件事就是建.gitignore别等到提交了一堆垃圾再回头删那样很麻烦。工作区还有一个概念叫“未跟踪”和“已跟踪”。新建的文件是未跟踪状态Git完全不知道它的存在一旦你用git add把它加进去它就变成已跟踪了。已跟踪的文件又分三种状态未修改、已修改、已暂存。这个分类听起来绕但你只要记住一句话——Git只关心它跟踪的文件的变化。2.2 暂存区提交前的“购物车”暂存区是我认为Git设计里最精妙也最容易被忽视的一环。你可以把它理解成超市购物车你在货架工作区上挑东西挑好了放进购物车暂存区最后到收银台提交一次性结账。为什么要多这一步因为不是所有改动你都希望一次性提交。举个例子你这次作业改了三个文件main.py修了一个bugutils.py加了一个新函数test.py是你自己写着玩的测试。你只想提交前两个第三个先不提交。这时候暂存区就派上用场了——你只git add main.py utils.pytest.py留在工作区不动。提交的时候只有前两个文件进仓库第三个还是未暂存状态。暂存区的命令主要是这几个git add 文件名把指定文件加入暂存区git add .把当前目录下所有改动加入暂存区注意这个会把删除操作也加进去git status查看当前哪些文件在暂存区、哪些没暂存git reset 文件名把文件从暂存区撤回到工作区git status是你最该常用的命令没有之一。我每次提交前必敲一遍确认一下到底有哪些东西要被提交。很多同学提交错了文件就是因为从来不看git status闭着眼睛git add .然后git commit结果把密码文件、大模型权重、几百兆的数据集全提交上去了。提示git add .和git add -A有细微区别。前者只处理当前目录及子目录后者处理整个仓库的所有改动包括仓库根目录之外的。新手用git add .就够了但一定要配合git status确认。2.3 本地仓库你电脑上的“存档点”暂存区的东西一旦git commit就正式进入本地仓库了。本地仓库藏在项目根目录下的.git文件夹里你平时看不到它但它记录了所有的提交历史。每次提交都会生成一个唯一的哈希值一串40位的十六进制字符用来标识这次提交。提交的时候要写提交信息就是git commit -m 你的说明。这个说明千万别乱写。我见过有人写“改了一下”“提交”“aaa”过两周自己回头看都不知道当时改了什么。好的提交信息应该让人一眼看懂这次改了什么、为什么改。比如修复登录页面密码校验逻辑错误添加数据预处理函数处理缺失值完成第三次作业的排序算法实现提交信息用中文完全没问题关键是说清楚。如果你提交信息写错了还没推送到远程可以用git commit --amend修改最近一次提交的信息。但一旦推送出去就别改了容易给别人造成麻烦。本地仓库还有一个重要概念叫分支。默认分支一般叫main或master。你可以把分支理解成平行宇宙每个分支上的提交互不影响。新手交作业一般用默认分支就够了但如果你要尝试新功能又怕改坏原来的代码可以开一个新分支git branch feature-sort git checkout feature-sort或者用一条命令git checkout -b feature-sort这样你在新分支上怎么折腾都不会影响主分支写好了再合并回去。交作业场景下我建议至少养成“主分支保持可运行”的习惯别在主分支上直接写一半没写完的代码。2.4 远程仓库作业最终要去的地方远程仓库就是放在服务器上的仓库比如学校提供的Git服务、团队自建的代码托管平台等。你本地提交完之后用git push把本地仓库的内容推送到远程仓库老师或助教就能看到了。远程仓库和本地仓库之间靠git clone、git pull、git push这三个命令连接git clone 仓库地址把远程仓库完整复制到本地包括所有历史记录git pull把远程仓库的新内容拉到本地并合并git push把本地的提交推送到远程这里有个新手最容易犯的错误先git pull再git push。如果你本地有提交远程也有别人推的新提交直接push会被拒绝。正确顺序是先pull把远程的改动合并进来解决可能的冲突再push。我一般建议每次开始写代码之前先pull一次写完提交后再pull一次再push养成习惯就不会出问题。还有一个坑是认证问题。第一次push的时候会要求你输入用户名和密码或者配置密钥。现在很多平台推荐用个人访问令牌代替密码具体看你用的平台的要求。如果push一直提示认证失败先检查是不是密码过期了或者令牌没配置对。3. 手把手实操从写代码到提交作业的完整流程3.1 第一次交作业从零初始化到推送假设你刚拿到作业要求要写一个Python程序实现某个功能并且用Git提交。完整流程是这样的。第一步在本地建项目文件夹初始化仓库mkdir homework-03 cd homework-03 git initgit init之后当前目录下会多一个.git隐藏文件夹这就是本地仓库。你可以用ls -a看到它。第二步配置你的身份信息。这个只需要配置一次之后所有仓库都用这个信息git config --global user.name 你的名字 git config --global user.email 你的邮箱注意这里的名字和邮箱会出现在每次提交记录里老师能看到。所以别用乱七八糟的昵称用真名或者学号加名字。第三步写代码。创建main.py写你的作业内容。写完之后用git status看一下git status你会看到main.py显示为红色表示未跟踪。这时候用git add main.py把它加入暂存区再git status它会变成绿色。第四步提交git commit -m 完成第三次作业实现排序功能提交成功后git log可以看到提交记录git log --oneline第五步关联远程仓库并推送。假设老师给了你一个远程仓库地址git remote add origin 仓库地址 git branch -M main git push -u origin main-u参数的作用是把本地main分支和远程main分支关联起来以后直接git push就行不用再指定分支。3.2 后续修改改完代码怎么再次提交作业交上去之后老师让你改个bug你改完main.py这时候流程是git status # 确认改了哪些文件 git diff # 看看具体改了什么内容 git add main.py # 加入暂存区 git commit -m 修复排序边界条件错误 git pushgit diff这个命令特别有用它显示的是工作区和暂存区的差异。你改完代码不确定改了啥敲一下git diff所有改动一目了然。如果已经git add了想看暂存区和上次提交的差异用git diff --cached。这里有个细节如果你改了多个文件但只想提交其中一部分可以分多次add和commit。比如先提交main.py的修复再提交README的更新这样提交历史更清晰。别嫌麻烦清晰的提交历史在出问题的时候能救命。3.3 多人协作场景pull、冲突与解决如果作业是小组合作远程仓库会有多个人的提交。你push之前必须先pullgit pull origin main如果远程和本地改的是不同文件pull会自动合并然后你直接push就行。但如果两个人改了同一个文件的同一行就会产生冲突。冲突的文件里会出现这样的标记 HEAD 你本地的代码 远程的代码 远程分支你需要手动决定保留哪部分把、、这些标记删掉改成最终想要的代码。然后git add 冲突文件 git commit -m 解决合并冲突 git push解决冲突是新手最怕的环节但其实逻辑很简单——Git不知道你要保留哪个版本所以让你自己选。选完之后告诉Git“我选好了”它就继续走。我建议小组作业提前约定好谁负责哪个文件尽量减少同时改同一个文件的情况。注意解决冲突的时候千万别慌也别直接删文件重新写。先看清楚两边的代码分别是什么想清楚要保留什么再动手改。改完一定要跑一遍代码确认没问题再提交。3.4 查看历史与回退提交错了怎么办提交历史用git log看加--oneline更简洁加--graph能看到分支合并的图形。如果你提交了不该提交的东西比如把密码写进代码提交了怎么办如果还没push可以用git reset回退git reset --soft HEAD~1 # 撤销最近一次提交改动保留在暂存区 git reset --mixed HEAD~1 # 撤销提交和暂存改动保留在工作区 git reset --hard HEAD~1 # 彻底撤销改动也删掉慎用--soft最安全它只是把提交撤销了你的代码改动还在。--hard会直接删掉你的改动用之前一定想清楚。如果已经push了那就麻烦了。你不能直接改远程历史因为别人可能已经拉取了。正确做法是再提交一次把错误的内容改回来然后push。比如密码泄露了先改代码去掉密码提交push然后去平台把那个密码作废。别想着用git push -f强制覆盖远程那会把别人的提交也搞没小组作业里这么干会被队友骂死。4. 常见报错与避坑速查表4.1 新手最常遇到的8个报错及解决方法下面这张表是我这些年被问得最多的问题基本覆盖了90%的新手报错。你可以把它当成急救手册遇到问题先查表。报错信息原因解决方法fatal: not a git repository当前目录不是Git仓库确认在项目根目录或先git initnothing to commit, working tree clean没有改动需要提交检查是否真的改了文件或改动已被提交failed to push some refs远程有本地没有的提交先git pull再git pushCONFLICT (content): Merge conflict合并冲突手动编辑冲突文件删掉标记add后commitPlease tell me who you are没配置用户名邮箱执行git config --global user.name/emailAuthentication failed认证失败检查密码或令牌重新输入pathspec xxx did not match文件名写错或文件不存在用git status确认文件名Your local changes would be overwritten本地改动会被覆盖先commit或stash再pullgit stash这个命令值得单独说一下。它的作用是把当前工作区的改动临时存起来让工作区变干净。比如你正在写代码突然要pull远程的新内容但本地改动又不想提交就可以git stash # 存起来 git pull # 拉取远程 git stash pop # 把存起来的改动恢复这个命令在多人协作时特别实用建议记住。4.2 提交作业前必须检查的5件事我每次收作业都会发现一些本可以避免的问题。下面这5条检查清单建议你每次push之前过一遍。第一git status确认没有未提交的改动。有时候你改了文件忘了addpush上去的还是旧版本老师看到的就是没改的代码。第二确认.gitignore生效了。用git status看看有没有__pycache__、.idea之类的文件夹被跟踪。如果有说明.gitignore没写对或者文件已经被跟踪了需要先git rm --cached再提交。第三git log --oneline看一眼提交历史。确认提交信息能看懂提交次数合理。别一次作业就一个“提交”了事。第四确认远程仓库地址正确。用git remote -v查看别推到别人的仓库去了。第五跑一遍代码确认能运行。这个听起来像废话但真的有人提交了跑不通的代码。Git只管版本不管你的代码对不对。4.3 几个让我印象深刻的翻车案例说几个我亲身经历或者见别人翻过的车你看了能少走很多弯路。有一次某同学交作业git add .之后直接commit结果把整个venv虚拟环境文件夹提交上去了几百兆push了半天推不上去。后来发现是.gitignore没写。这个问题的教训是项目初始化第一件事就是写.gitignore别等提交了才发现。还有一次小组作业两个人同时改了main.py一个人push之后另一个人直接push被拒然后那个人用了git push -f强制覆盖把队友的代码全冲掉了。这个教训是永远不要对共享分支用-f除非你百分之百确定只有你一个人在用。我自己也翻过车。有一次改完代码git add之后没仔细看git statuscommit完push上去才发现有个测试文件里写了数据库密码。虽然马上改了重新提交但密码已经进了历史记录。后来只能去把那个密码改掉。这个教训是提交前一定看git status和git diff确认没有敏感信息。还有一个常见的坑是换行符问题。Windows和Linux的换行符不一样有时候Git会提示LF will be replaced by CRLF。这个一般不影响功能但如果你的代码在别人电脑上跑出奇怪问题可以检查一下换行符配置。用git config --global core.autocrlf查看Windows一般设trueLinux和Mac设input。5. 把Git用顺手的几个进阶习惯5.1 分支策略别在主分支上乱来虽然交作业场景下分支用得不多但养成好习惯没坏处。我的建议是主分支main永远保持可运行状态新功能开新分支写写完测试通过再合并回主分支。具体操作git checkout -b feature-homework # 开新分支 # 写代码addcommit git checkout main # 切回主分支 git merge feature-homework # 合并 git branch -d feature-homework # 删除已合并的分支这样即使新功能写了一半发现思路不对直接切回main就行主分支上的代码始终是好的。小组作业里每个人开自己的分支最后统一合并能避免很多冲突。5.2 提交粒度小步提交比一次大提交好我见过有人写完整次作业才提交一次提交信息写“完成作业”。这种提交历史基本没有价值出了问题没法定位。更好的做法是每完成一个小功能就提交一次。比如添加读取输入文件的函数实现核心排序逻辑添加异常处理补充单元测试更新README说明这样每次提交都是一个逻辑完整的改动回退的时候可以精确回退到某个功能点而不是一退全退。而且提交信息本身就成了开发日志回头看很清楚。5.3 用别名简化常用命令Git命令有时候确实长你可以配置别名来简化。比如git config --global alias.st status 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配置完之后git st就等于git statusgit lg就是带图形的简洁日志。这个纯属个人习惯但用顺了能省不少敲键盘的时间。5.4 遇到问题先看帮助文档最后说一个心态问题。很多同学遇到Git报错第一反应是慌然后上网乱搜搜到的答案可能不适用自己的情况。其实Git自带的帮助文档非常详细git help 命令或者git 命令 --help就能看到完整说明。比如git help commit会告诉你commit的所有参数和用法。英文看不懂也没关系现在浏览器翻译很方便。关键是养成“先看官方说明再搜解决方案”的习惯这样你学到的是系统性的知识而不是零散的偏方。我个人在实际操作中的体会是Git这东西入门确实有个坎但一旦你把工作区、暂存区、本地仓库、远程仓库这四个阶段的关系理顺了后面就顺了。刚开始可以慢一点每次提交前都git status看一眼确认自己在干什么。交几次作业之后这些命令就会变成肌肉记忆。到那时候你再看那些还在用压缩包交作业的同学就会觉得Git真香。
阅读完成 · 觉得有帮助？
