.gitignore 是一个 Git 用来忽略文件的配置文件。
它的作用是告诉 Git:
“某些文件或目录不需要纳入版本控制系统中。”
🔧 常见用途:
在项目开发过程中,会产生很多 不需要提交 到 Git 的文件,比如:
编译生成的二进制文件(如
.class,.jar)IDE 配置(如
.idea/,.vscode/)系统文件(如
Thumbs.db,.DS_Store)临时文件(如日志、缓存)
环境配置(如
.env,local.properties)
这些都可以通过 .gitignore 忽略。
📌 示例:.gitignore 文件内容
target/
.mvn
!.mvn/wrapper/maven-wrapper.jar
!**/src/main/**/target/
!**/src/test/**/target/
application-local.yml
### STS ###
.apt_generated
.classpath
.factorypath
.project
.settings
.springBeans
.sts4-cache
.DS_Store
### IntelliJ IDEA ###
.idea
*.iws
*.iml
*.ipr
mvnw
mvnw.cmd
### NetBeans ###
/nbproject/private/
/nbbuild/
/dist/
/nbdist/
/.nb-gradle/
build/
!**/src/main/**/build/
!**/src/test/**/build/
### VS Code ###
.vscode/
📁 放在哪里?
.gitignore文件放在Git 仓库根目录下。也可以在子目录中再写
.gitignore,只作用于该子目录及以下。
⚠️ 注意
.gitignore 只能忽略未被 Git 跟踪(untracked)的文件。 如果某个文件已经被 Git 管理(已 commit),即使加到 .gitignore 中,也不会被忽略,必须先用:
git rm --cached 文件名然后再提交一次。