了解 .gitignore 文件
学习 .gitignore 如何通过模式、作用域规则和常见陷阱,阻止不需要的文件进入您的仓库。
了解 .gitignore 文件 是 CoddyKit 上的免费 Git & GitHub Professional Workflow 课时。 这是第 4 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Git & GitHub Professional Workflow 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 Git & GitHub Professional Workflow 课程共包含 4 节课。
并非所有内容都属于 Git
构建产物、日志、密钥和依赖项目录绝不应提交。.gitignore 文件会准确告诉 Git 要跳过哪些文件。
什么是 .gitignore?
.gitignore 其实就是一个包含大量模式的文本文件。任何与某个模式匹配的路径都会被排除在暂存和提交之外,从而保持仓库整洁。
创建您的第一个 .gitignore
在仓库根目录放置一个 .gitignore,每行写一个模式。下面的示例会忽略依赖项、日志和环境文件。
# .gitignore
node_modules/
*.log
.env基本模式规则
基本的模式包括:*.log 按扩展名匹配,build/ 匹配整个目录,而普通名称只匹配一个完全相同的文件。
*.tmp
dist/
config.local.json使用开头的斜杠固定范围
开头的斜杠会将模式固定到仓库根目录,因此 /todo.txt 只会忽略顶层文件,而不会忽略目录树更深处同名的文件。
# only ignores /todo.txt at the root
/todo.txt
# ignores todo.txt anywhere
todo.txt使用感叹号进行否定
在模式前加上 !,即可取消之前规则的排除效果,例如忽略所有日志,但保留其中一个您想留下的日志文件。
# ignore all logs except the important one
*.log
!important.log通配符:星号和双星号
关于通配符:单个 * 可以匹配除斜杠以外的任何内容,而 ** 可以跨越任意深度的目录进行匹配。
# any file in any logs directory at any depth
**/logs/*.log
# any .cache file in this dir or below
**/*.cache注释和空行
以 # 开头的行是注释,空行会被跳过——同时使用这两者,可以让您的 .gitignore 保持整洁易读。
# Dependencies
node_modules/
# Environment
.env已跟踪文件陷阱
一个重要陷阱是:.gitignore 仅影响未跟踪的文件。如果文件已经被跟踪,该规则不会生效,除非您使用 git rm --cached 取消跟踪它。
git rm --cached secret.txt
# now the ignore rule takes effect for future commits检查文件为何被忽略
不确定某个路径为何被忽略?git check-ignore -v 会准确告诉您匹配它的是哪条规则以及哪一行。
git check-ignore -v build/app.js
# .gitignore:2:build/ build/app.js全局忽略
对于编辑器配置、OS 垃圾文件等不应进入任何仓库的个人杂项,请设置全局忽略规则,而不要污染项目文件。
git config --global core.excludesFile ~/.gitignore_global快速检查
测试您对 .gitignore 的了解。
回顾
您已经掌握了 .gitignore:模式、通配符(*、**)、范围固定(/)和否定(!)。请记住,它只影响未跟踪的文件——使用 git check-ignore 进行排查。
常见问题解答
「了解 .gitignore 文件」课时是免费的吗?
是的 — 「了解 .gitignore 文件」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 Git & GitHub Professional Workflow 课程的其余内容,请升级到 CoddyKit PRO。 Git & GitHub Professional Workflow 课程共包含 4 节课。
「了解 .gitignore 文件」这节课中我会学到什么?
学习 .gitignore 如何通过模式、作用域规则和常见陷阱,阻止不需要的文件进入您的仓库。 你通过在浏览器中直接运行的动手代码来练习 Git & GitHub Professional Workflow,全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Git & GitHub Professional Workflow 需要有经验吗?
无需任何先前经验。CoddyKit 上的 Git & GitHub Professional Workflow 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 4 节课,共 4 节。
「了解 .gitignore 文件」课时需要多长时间?
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。
我能在这节 Git & GitHub Professional Workflow 课中编写并运行代码吗?
能。每节 Git & GitHub Professional Workflow 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。
此课程中的所有课时
- 版本控制简介
- 安装 Git 与配置
- 创建您的第一个仓库
- 了解 .gitignore 文件