.gitignore使用指南

.gitignore使用指南

目录

• 什么是.gitignore
  
• 为什么须要.gitignore
  
• 如何创建.gitignore文件
  
• .gitignore文件的语法规则
  
  
  
  • 忽略单个文件
    
  • 忽略目录
    
  • 忽略特定类型的文件
    
  • 不忽略特定文件或目录
    
  • 递归匹配
    
  
  
• 示例.gitignore文件
  
• 留意事项
  
• 更多特别场景匹配规则
  
  
  
  • 忽略多个特定后缀的文件
    
  • 忽略特定目录下的所有隐藏文件
    
  
  
• 跨平台使用差别
  
  
  
  • 路径分隔符差别
    
  • 大小写敏感性差别
    
  • 忽略特定前缀的文件
    
  • 忽略特定后缀的文件
    
  
  
• 与其他工具集成
  
  
  
  • 与IDE集成
    
  • 与持续集成工具集成
    
  
  
• 更复杂的匹配规则
  
  
  
  • 忽略特定目录下的特定文件
    
  • 忽略特定目录下的所有文件
    
  
  
• 不同项目类型的最佳实践
  
  
  
  • Python项目
    
  • Java项目
    
  • JavaScript项目
    
  • Go项目
    
  • C++项目
    
  • 更复杂的匹配规则
    
    
    
    • 忽略特定目录下特定后缀的文件
      
    • 忽略特定目录下特定前缀的文件
      
    • 忽略特定目录下特定后缀和前缀的文件
      
    
    
  
  

什么是.gitignore

.gitignore 是一个文本文件，用于告诉Git哪些文件或目录在版本控制中应该被忽略。当你实行 git add 下令时，Git会参考 .gitignore 文件的内容，不会将其中指定的文件添加到暂存区。
为什么须要.gitignore

在项目开辟过程中，有些文件是不须要进行版本控制的，比方：

• 编译天生的文件：如 .class、.pyc 等。
  
• 日记文件：如 .log 文件。
  
• 临时文件：如 .tmp 文件。
  
• 依赖文件：如 node_modules 目录。
  

使用 .gitignore 可以避免将这些文件添加到版本库中，减少版本库的大小，同时也可以避免不须要的文件冲突。
如何创建.gitignore文件

在项目根目录下创建一个名为 .gitignore 的文件，可以使用以下下令：

1. touch .gitignore

复制代码

.gitignore文件的语法规则

忽略单个文件

要忽略单个文件，只需在 .gitignore 文件中写入该文件的名称，比方：

1. test.txt

复制代码

这将忽略项目根目录下的 test.txt
文件。
忽略目录

要忽略整个目录，在目录名称后面加上斜杠 /，比方：

1. logs/

复制代码

这将忽略项目根目录下的 logs 目录及其所有子目录和文件。
忽略特定类型的文件

可以使用通配符 * 来忽略特定类型的文件，比方：

1. *.log

复制代码

这将忽略所有以 .log 结尾的文件。
不忽略特定文件或目录

如果你想在忽略某个目录的同时，不忽略其中的某个文件或子目录，可以使用 ! 符号，比方：

1. logs/
3. !logs/
4. important.log

复制代码

这将忽略 logs 目录下的所有文件，但不忽略 logs/

important.log 文件。
递归匹配

使用 ** 可以进行递归匹配，比方：

1. **/*.log

复制代码

这将忽略项目中所有目录下的 .log 文件。
示例 .gitignore 文件

以下是一个常见的 .gitignore 文件示例，实用于Python项目：

1. # Byte-compiled / optimized / DLL files __pycache__/ *.pyc *.pyo *.pyd # C extensions *.so # Distribution / packaging dist/ build/ *.egg-info/ # Logs and databases *.log
2. *.sql *.sqlite # IDEs and editors .idea/ .vscode/ *.iml

复制代码

留意事项

• .gitignore 文件只对未被跟踪的文件有效：如果一个文件已经被Git跟踪，即使在 .gitignore 文件中添加了该文件，Git仍然会继续跟踪它。如果你想忽略已经被跟踪的文件，可以使用 git rm --cached 下令将其从版本库中移除。
  
• .gitignore 文件的位置：.gitignore 文件通常放在项目根目录下，但也可以在子目录中创建 .gitignore 文件，子目录中的 .gitignore 文件只对该子目录及其子目录有效。
  
• .gitignore 文件的优先级：子目录中的 .gitignore 文件会覆盖父目录中的 .gitignore 文件。
  

更多特别场景匹配规则

忽略多个特定后缀的文件

可以使用 | 结合正则表达式来忽略多个特定后缀的文件，须要在 .gitignore 文件中使用正则表达式模式，同时要确保 Git 支持正则表达式模式匹配。比方：

1. *.(log|tmp|bak)

复制代码

这将忽略所有以 .log、.tmp 或 .bak 结尾的文件。
忽略特定目录下的所有隐藏文件

可以使用 / 结合特定目录和隐藏文件的前缀 . 来忽略特定目录下的所有隐藏文件，比方：

1. /logs/
3. .*

复制代码

这将忽略 logs 目录下的所有隐藏文件。
跨平台使用差别

路径分隔符差别

在 Windows 系统中，路径分隔符是反斜杠 \，而在 Linux 和 macOS 系统中，路径分隔符是正斜杠 /。在 .gitignore 文件中，应该始终使用正斜杠 / 作为路径分隔符，由于 Git 会主动处置惩罚不同系统的路径分隔符差别。比方：

1. logs/

复制代码

无论是在 Windows、Linux 照旧 macOS 系统中，这个规则都会精确忽略 logs 目录。
大小写敏感性差别

在 Windows 和 macOS 系统中，文件系统默认是大小写不敏感的，而在 Linux 系统中，文件系统默认是大小写敏感的。这意味着在 .gitignore 文件中，大小写的匹配规则大概会有所不同。比方：

1. Test.txt

复制代码

在 Windows 和 macOS 系统中，这个规则会忽略 Test.txt
、test.txt 等文件，而在 Linux 系统中，只会忽略 Test.txt
文件。如果须要在不同系统中保持划一的匹配规则，发起在 .gitignore 文件中使用划一的大小写。
忽略特定前缀的文件

可以使用 * 结合特定前缀来忽略以特定字符串开头的文件，比方：

1. prefix_*

复制代码

这将忽略所有以 prefix_ 开头的文件。
忽略特定后缀的文件

除了使用 * 忽略特定后缀的文件，还可以使用 ? 来匹配单个字符，比方：

1. *.log?

复制代码

这将忽略所有以 .log 开头，后面跟一个任意字符的文件。
与其他工具集成

与IDE集成

很多集成开辟环境（IDE）可以主动识别 .gitignore 文件，并在文件浏览和搜索中排除被忽略的文件。比方，在IntelliJ IDEA中，被 .gitignore 文件忽略的文件会以灰色体现，而且不会出如今项目搜索结果中。
与持续集成工具集成

在持续集成（CI）环境中，.gitignore 文件可以资助排除不须要的文件，减少构建时间和资源消耗。比方，在Jenkins或GitLab CI/CD中，构建过程会主动遵循 .gitignore 文件的规则，只处置惩罚须要的文件。
更复杂的匹配规则

忽略特定目录下的特定文件

可以使用 / 结合特定目录和文件名来忽略特定目录下的特定文件，比方：

1. /logs/
3. *.log

复制代码

这将忽略 logs 目录下的所有 .log 文件。
忽略特定目录下的所有文件

可以使用 / 结合特定目录来忽略特定目录下的所有文件，比方：

1. /logs/

复制代码

这将忽略 logs 目录下的所有文件。
不同项目类型的最佳实践

Python项目

1. # Byte-compiled / optimized / DLL files
2. __pycache__/
3. *.pyc
4. *.pyo
5. *.pyd
7. # C extensions
8. *.so
10. # Distribution / packaging
11. /dist/
12. /build/
13. *.egg-info/
15. # Logs and databases
16. *.log
17. *.sql
18. *.sqlite
20. # IDEs and editors
21. .idea/
22. .vscode/
23. *.iml

复制代码

Java项目

1. # Compiled class file
2. *.class
4. # Log file
5. *.log
7. # BlueJ files
8. *.ctxt
10. # Mobile Tools for Java (J2ME)
11. .mtj.tmp/
13. # Package Files #
14. *.jar
15. *.war
16. *.nar
17. *.ear
18. *.zip
19. *.tar.gz
20. *.rar
22. # virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
23. hs_err_pid*

复制代码

JavaScript项目

1. # Logs
2. logs
3. *.log
4. npm-debug.log*
5. yarn-debug.log*
6. nyan-debug.log*
8. # Runtime data
9. pids
10. *.pid
11. *.seed
12. *.pid.lock
14. # Directory for instrumented libs generated by jscoverage/JSCover
15. lib-cov
17. # Coverage directory used by tools like istanbul
18. coverage
20. # nyc test coverage
21. .nyc_output
23. # Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
24. .grunt
26. # Bower dependency directory (https://bower.io/)
27. bower_components
29. # node-waf configuration
30. .lock-wscript
32. # Compiled binary addons (http://nodejs.org/api/addons.html)
33. build/Release
35. # Dependency directories
36. node_modules/
37. jspm_packages/
39. # TypeScript v1 declaration files
40. typings/
42. # TypeScript cache
43. .tscache

复制代码

Go项目

1. # Binaries for programs and plugins
2. *.exe
3. *.exe~
4. *.dll
5. *.so
6. *.dylib
8. # Test binary, built with "go test -c"
9. *.test
11. # Output of the go coverage tool, specifically when used with LiteIDE
12. *.out

复制代码

C++项目

1. # Compiled Object files
2. *.slo
3. *.lo
4. *.o
5. *.obj
7. # Precompiled Headers
8. *.gch
9. *.pch
11. # Compiled Dynamic libraries
12. *.so
13. *.dylib
14. *.dll
16. # Fortran module files
17. *.mod
18. *.smod
20. # Executables
21. *

复制代码

更复杂的匹配规则

忽略特定目录下特定后缀的文件

可以使用 / 结合特定目录和后缀来忽略特定目录下特定后缀的文件，比方：

1. /logs/
3. *.log

复制代码

这将忽略 logs 目录下的所有 .log 文件。
忽略特定目录下特定前缀的文件

可以使用 / 结合特定目录和前缀来忽略特定目录下特定前缀的文件，比方：

1. /logs/
3. prefix_*

复制代码

这将忽略 logs 目录下所有以 prefix_ 开头的文件。
忽略特定目录下特定后缀和前缀的文件

可以使用 / 结合特定目录、前缀和后缀来忽略特定目录下特定后缀和前缀的文件，比方：

1. /logs/
3. prefix_*
4. .log

复制代码

这将忽略 logs 目录下所有以 prefix_ 开头且以 .log 结尾的文件。
以上就是 .gitignore 文件的基本使用指南以及更多特别匹配规则和不同项目类型的最佳实践等内容，希望对你有所资助。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。