第 19 天：设定 .gitignore 忽略清单

Previous第 18 天：修正 commit 过的版本历史记录 Part 1 Next第 20 天：修正 commit 过的版本历史记录 Part 2

Last updated 1 year ago

第 19 天：设定 .gitignore 忽略清单

在开发项目时，工作目录下可能经常会有新的文件产生 (可能是通过 Visual Studio 工具产生的那些暂存文件或快照文件)，可能有许多文件并不需要列入版本控制，所以必须要排除这些文件，我们称为「忽略清单」。

关于 .gitignore 文件

在 Git 里面，是通过 .gitignore 文件来进行定义「忽略清单」，主要的目的是排除一些不需要加入版控的文件，列在里面的档名或路径 (可包含万用字元)，都不会出现在 git status 的结果中，自然也不会在执行 git add 的时候被加入。不过，这仅限于 Untracked file 而已，那些已经列入版控的文件 (Staged file)，不受 .gitignore 文件控制。

通过 GitHub 建立预设的忽略清单

如果你曾经在 GitHub 建立过项目，可能会用过这个功能，就在建立新的仓库(Repository)时，可以让你选择 GitHub 预先帮你定义好的忽略清单，这个忽略清单其实就只是一个文件而已，其档名为 .gitignore，并预设置于项目跟目录下。

我们以上图这个 CSharp 项目为例，建立完成后，在仓库中就会出现一个预设的 .gitignore 文件：

# Build Folders (you can keep bin if you'd like, to store dlls and pdbs)
[Bb]in/
[Oo]bj/

# mstest test results
TestResults

## Ignore Visual Studio temporary files, build results, and
## files generated by popular Visual Studio add-ons.

# User-specific files
*.suo
*.user
*.sln.docstates

# Build results
[Dd]ebug/
[Rr]elease/
x64/
*_i.c
*_p.c
*.ilk
*.meta
*.obj
*.pch
*.pdb
*.pgc
*.pgd
*.rsp
*.sbr
*.tlb
*.tli
*.tlh
*.tmp
*.log
*.vspscc
*.vssscc
.builds

# Visual C++ cache files
ipch/
*.aps
*.ncb
*.opensdf
*.sdf

# Visual Studio profiler
*.psess
*.vsp
*.vspx

# Guidance Automation Toolkit
*.gpState

# ReSharper is a .NET coding add-in
_ReSharper*

# NCrunch
*.ncrunch*
.*crunch*.local.xml

# Installshield output folder 
[Ee]xpress

# DocProject is a documentation generator add-in
DocProject/buildhelp/
DocProject/Help/*.HxT
DocProject/Help/*.HxC
DocProject/Help/*.hhc
DocProject/Help/*.hhk
DocProject/Help/*.hhp
DocProject/Help/Html2
DocProject/Help/html

# Click-Once directory
publish

# Publish Web Output
*.Publish.xml

# NuGet Packages Directory
packages

# Windows Azure Build Output
csx
*.build.csdef

# Windows Store app package directory
AppPackages/

# Others
[Bb]in
[Oo]bj
sql
TestResults
[Tt]est[Rr]esult*
*.Cache
ClientBin
[Ss]tyle[Cc]op.*
~$*
*.dbmdl
Generated_Code #added for RIA/Silverlight projects

# Backup & report files from converting an old project file to a newer
# Visual Studio version. Backup files are not needed, because we have git ;-)
_UpgradeReport_Files/
Backup*/
UpgradeLog*.XML