讲师中心 微信公众号
AI工具推荐 视频效率加速

Git如何忽略已提交的文件_Git .gitignore文件配置详解

轻墨同学_6639

轻墨同学_6639

发布时间:2026-05-09 08:48:00

|

317人浏览过

|

来源于php中文网

原创

.gitignore只对从未被Git追踪的文件生效;已提交文件必须先用git rm --cached解除追踪,再写入规则并提交,才能真正忽略。

git如何忽略已提交的文件_git .gitignore文件配置详解

.gitignore 对已提交文件完全无效

直接说结论:.gitignore 只对「从未被 Git 追踪过」的文件起作用。如果一个文件已经执行过 git add 和 git commit,哪怕你立刻在 .gitignore 里加上规则,Git 仍会继续追踪它——不会自动停止跟踪,也不会在下次 git status 中隐藏它。

这是最常被误解的一点:很多人删掉 .gitignore 里的某条规则,以为文件就“重新被纳入管理”了;或者新增一条规则,以为刚 git add 错的配置文件就“被忽略”了——其实都不成立。

  • 已提交的文件 → 必须先用 git rm --cached 手动解除追踪
  • 解除后该文件变成「未跟踪状态」→ 此时 .gitignore 规则才开始生效
  • 若想保留本地文件(比如 .env),一定加 --cached,不加会连本地磁盘文件一起删

如何安全地忽略已提交但不该提交的文件

典型场景:误提交了 .idea/、target/、node_modules/ 或 .env,现在想让它彻底从 Git 历史中“消失”,但又不想删掉自己电脑上的文件。

分三步操作(缺一不可):

  • 确认文件当前是否已被追踪:git ls-files | grep "pattern"(例如 git ls-files | grep ".idea")
  • 解除追踪(保留本地文件):git rm -r --cached .idea/(目录加 -r;单个文件省略)
  • 把规则写进 .gitignore:echo ".idea/" >> .gitignore,再 git add .gitignore
  • 最后提交:git commit -m "ignore .idea directory"

注意:git rm --cached 不会删除工作区文件,但会把它从暂存区移除;后续 git status 会显示为 “deleted”,这是正常现象——因为 Git 已不再管它了。

Github Auto
Github Auto

管PR、盯Issue、跑CI、发Release——GitHub仓库日常运维扔给它。少开几个Chrome标签页。

下载

/ 开头和 **/ 的区别决定忽略范围

很多规则看似相似,实际匹配行为天差地别。关键看路径开头有没有 /,以及有没有用 **。

  • dist/ → 匹配所有名为 dist/ 的目录,无论在哪层(src/dist/、build/dist/ 都中招)
  • /dist/ → 只匹配项目根目录下的 dist/(src/dist/ 不受影响)
  • **/log → 匹配任意深度的 log 目录或文件(log、a/log、a/b/c/log)
  • log → 匹配所有叫 log 的文件或目录(包括 alog、logging,因为 * 是前缀通配)
  • !src/main/resources/config.yaml → 要放在 src/** 或 src/ 规则之后才有意义,否则没东西可“反忽略”

常见翻车点:build(没加 /)会意外匹配 rebuild.sh;**/node_modules 比 node_modules/ 更彻底,能覆盖嵌套的 yarn workspace 子包里的 node_modules。

全局忽略 vs 本地 exclude vs 仓库 .gitignore

Git 实际按固定顺序检查三类忽略规则,优先级从高到低:

  • .git/info/exclude:仅当前仓库生效,不提交,适合放个人临时文件(如 *.swp、~ 备份)
  • ~/.gitignore_global(需 git config --global core.excludesfile 指定):影响你机器上所有 Git 仓库,适合操作系统级文件(.DS_Store、Thumbs.db)
  • .gitignore(仓库根目录):团队共享,必须提交,用于项目通用产物(target/、__pycache__/)

查当前生效的全局路径:git config --get core.excludesfile;如果返回空,说明没设全局忽略文件。不要把本该全局的规则(如 .DS_Store)塞进每个项目的 .gitignore,既重复又难维护。

真正容易被忽略的是:一旦某条规则在更高优先级的文件里被匹配并忽略,低优先级文件里的同名 ! 否定规则就失效了——比如全局忽略了 *.log,你在项目 .gitignore 里写 !server.log 是没用的。

热门AI工具

更多
讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

相关专题

更多
自建git服务器
自建git服务器

git服务器是目前流行的分布式版本控制系统之一,可以让多人协同开发同一个项目。本专题为大家提供自建git服务器相关的各种文章、以及下载和课程。

5979

2023.07.05

git和svn的区别
git和svn的区别

git和svn的区别:1、定义不同;2、模型类型不同;3、存储单元不同;4、是否拥有全局版本号;5、内容完整性不同;6、版本库不同;7、克隆目录速度不同;8、分支不同。php中文网为大家带来了git和svn的相关知识、以及相关文章等内容。

1760

2023.07.06

git撤销提交的commit
git撤销提交的commit

Git是一个强大的版本控制系统,它提供了很多功能帮助开发人员有效地管理和控制代码的变更,本专题为大家提供git 撤销提交的commit相关的各种文章内容,供大家免费下载体验。

1034

2023.07.24

git提交错误怎么撤回
git提交错误怎么撤回

git提交错误撤回的方法:git reset head^:撤回最后一次提交,恢复到提交前状态。git revert head:创建新提交,内容与之前提交相反。git reset :使用提交的 sha-1 哈希撤回指定提交。交互式舞台区:标记要撤回的特定更改,然后提交,排除已撤回更改。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3897

2024.04.09

git怎么对比两个版本的文件内容
git怎么对比两个版本的文件内容

要对比两个版本的 git 文件,请使用 git diff 命令:git diff 比较工作树和暂存区之间的差异。git diff 比较两个提交或标签之间的差异。git diff 输出显示差异块,其中 + 表示添加的行,- 表示删除的行, 表示修改的行。可使用 gitkraken、meld、beyond compare 等可视化工具更直观地查看差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3621

2024.04.09

PixTV官网入口地址合集
PixTV官网入口地址合集

本专题汇总了 PixTV AI 一站式视频创作平台的官方入口与使用教程。无需下载软件,浏览器直接访问即可使用。平台将剧本、图像、视频、声音与剪辑整合在“无限画布”中,接入 GPT Image 2.5、Seedance 2.5 等头部模型。本专题整理了从新建画布、角色锚定、分镜拆分到视频生成与导出的完整操作指南,助你快速上手 AI 短剧与漫剧创作。

20

2026.10.10

Kratos框架HTTP与gRPC服务开发教程
Kratos框架HTTP与gRPC服务开发教程

本专题围绕Kratos框架双协议服务开发,涵盖HTTP路由与处理器编写、参数获取、gRPC服务实现与客户端调用、metadata上下文传递、encoding编解码注册、统一响应封装、超时控制与流式响应实现方法。

20

2026.10.10

Kratos框架Protobuf接口定义与代码生成合集
Kratos框架Protobuf接口定义与代码生成合集

本专题讲解Kratos框架接口定义体系,涵盖proto编写规范、proto add/client/server生成命令、http注解路由、validate校验、OpenAPI文档生成、跨服务proto复用与兼容性设计。

0

2026.10.10

C++虚函数怎么定义和调用
C++虚函数怎么定义和调用

C++虚函数是实现运行时多态的重要机制。本专题从virtual关键字的基本用法入手,介绍基类与派生类之间的函数重写、基类指针调用派生类方法,以及动态绑定的执行过程,帮助初学者掌握虚函数的核心语法。

20

2026.10.10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
vscode手册
vscode手册

共0课时 | 0人学习

Git 教程
Git 教程

共21课时 | 8万人学习

Git版本控制工具
Git版本控制工具

共8课时 | 1.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn