引言
在软件开发过程中，版本控制系统是不可或缺的工具。Subversion（SVN）作为一种流行的集中式版本控制系统，被广泛应用于各种项目中。然而，在使用SVN管理代码时，经常会遇到一些不必要的文件（如编译产物、临时文件、IDE配置文件等）被误提交到版本库中的问题。这些文件不仅会占用版本库空间，还会造成版本历史混乱，影响团队协作效率。
SVN的忽略文件功能正是为了解决这一问题而设计的。通过合理配置忽略文件，我们可以确保只有真正需要版本控制的文件被提交到版本库，从而保持代码库的整洁和高效。本文将详细介绍SVN中配置忽略文件的各种方法、最佳实践以及常见问题的解决方案，帮助开发者更好地管理SVN版本库。
SVN忽略文件的基本原理
SVN的忽略文件功能基于模式匹配机制。当SVN执行诸如svn status、svn add或svn import等命令时，它会检查工作副本中的文件和目录，并根据配置的忽略模式来决定是否处理这些文件。
忽略模式可以是简单的文件名，也可以是包含通配符的复杂模式。SVN支持以下通配符：
*：匹配任意字符序列（除了路径分隔符）
?：匹配单个字符（除了路径分隔符）
[abc]：匹配方括号内的任意一个字符
[a-z]：匹配指定范围内的任意一个字符
需要注意的是，SVN的忽略模式只对未版本控制的文件和目录有效。一旦文件或目录被添加到版本控制中，忽略模式将不再对其生效。
全局忽略文件的配置方法
全局忽略文件是在SVN客户端级别配置的，它会对该客户端上的所有工作副本生效。配置全局忽略文件可以避免在每个项目中重复设置相同的忽略规则。
在Windows系统上配置全局忽略文件
在Windows系统上，可以通过编辑注册表来配置全局忽略文件：
打开注册表编辑器（regedit）
导航到HKEY_CURRENT_USER\Software\TortoiseSVN
创建一个新的字符串值，命名为GlobalIgnoreList
设置该值为需要忽略的文件模式，多个模式用分号分隔
例如，要忽略常见的临时文件和编译产物，可以设置如下值：
*.o *.lo *.la *.al .libs *.so *.so.[0-9]* *.a *.pyc *.pyo __pycache__ *.rej *~ #*# .#* .*.swp .DS_Store Thumbs.db *.bak *.tmp *.log
在Unix-like系统上配置全局忽略文件
在Unix-like系统（如Linux、macOS）上，可以通过编辑Subversion的配置文件来设置全局忽略文件：
打开终端
编辑Subversion配置文件，通常位于~/.subversion/config
找到[miscellany]部分，取消global-ignores行的注释
设置需要忽略的文件模式，多个模式用空格分隔
例如：
[miscellany]
global-ignores = *.o *.lo *.la *.al .libs *.so *.so.[0-9]* *.a *.pyc *.pyo __pycache__ *.rej *~ #*# .#* .*.swp .DS_Store Thumbs.db *.bak *.tmp *.log
使用命令行配置全局忽略文件
除了直接编辑配置文件外，还可以使用svn config命令来配置全局忽略文件：
svn config set miscellany global-ignores "*.o *.lo *.la *.al .libs *.so *.so.[0-9]* *.a *.pyc *.pyo __pycache__ *.rej *~ #*# .#* .*.swp .DS_Store Thumbs.db *.bak *.tmp *.log"
项目特定忽略文件的配置方法
除了全局忽略文件外，SVN还支持为特定项目配置忽略文件。这种方式更加灵活，可以根据项目的具体需求定制忽略规则。
使用svn:ignore属性
svn:ignore是SVN中用于指定忽略模式的目录属性。通过设置这个属性，可以指定在特定目录下需要忽略的文件和目录。
设置svn:ignore属性
使用svn propset命令可以设置svn:ignore属性：
svn propset svn:ignore "*.pyc
__pycache__
*.log
.DS_Store" .
这个命令会在当前目录设置svn:ignore属性，忽略所有.pyc文件、__pycache__目录、.log文件和.DS_Store文件。
编辑svn:ignore属性
如果需要修改已存在的svn:ignore属性，可以使用svn propedit命令：
svn propedit svn:ignore .
这个命令会打开一个文本编辑器，允许你编辑当前目录的忽略模式列表。编辑完成后保存并退出，SVN会自动更新属性。
查看svn:ignore属性
使用svn propget命令可以查看目录的svn:ignore属性：
svn propget svn:ignore .
删除svn:ignore属性
如果需要删除svn:ignore属性，可以使用svn propdel命令：
svn propdel svn:ignore .
使用svn:global-ignores属性
SVN 1.8及以上版本支持svn:global-ignores属性，它与svn:ignore类似，但会递归应用到子目录。这对于需要在整个项目中统一忽略某些文件类型的情况非常有用。
设置svn:global-ignores属性的方法与svn:ignore类似：
svn propset svn:global-ignores "*.pyc
__pycache__
*.log
.DS_Store" .
使用外部文件定义忽略规则
对于复杂的忽略规则，可以将它们定义在一个外部文件中，然后通过svn:ignore属性引用这个文件。
首先，创建一个包含忽略规则的文件，例如.svnignore：
# Python
*.pyc
__pycache__/
# Logs
*.log
# OS generated files
.DS_Store
.DS_Store?
._*
.Spotlight-V100
.Trashes
ehthumbs.db
Thumbs.db
# IDE
.vscode/
.idea/
*.swp
*.swo
然后，使用svn propset命令将这个文件的内容设置为svn:ignore属性：
svn propset svn:ignore -F .svnignore .
这种方法的好处是可以将忽略规则版本化，并且可以在多个目录之间共享相同的忽略规则。
常见需要忽略的文件类型和模式
不同类型的项目和开发环境会产生不同的临时文件和配置文件。以下是一些常见需要忽略的文件类型和模式，可以根据项目需求进行选择和调整。
Python项目
# Byte-compiled / optimized / DLL files
__pycache__/
*.py[cod]
*$py.class
# C extensions
*.so
# Distribution / packaging
.Python
build/
develop-eggs/
dist/
downloads/
eggs/
.eggs/
lib/
lib64/
parts/
sdist/
var/
wheels/
*.egg-info/
.installed.cfg
*.egg
MANIFEST
# PyInstaller
*.manifest
*.spec
# Installer logs
pip-log.txt
pip-delete-this-directory.txt
# Unit test / coverage reports
htmlcov/
.tox/
.nox/
.coverage
.coverage.*
.cache
nosetests.xml
coverage.xml
*.cover
.hypothesis/
.pytest_cache/
# Translations
*.mo
*.pot
# Django stuff:
*.log
local_settings.py
db.sqlite3
# Flask stuff:
instance/
.webassets-cache
# Scrapy stuff:
.scrapy
# Sphinx documentation
docs/_build/
# PyBuilder
target/
# Jupyter Notebook
.ipynb_checkpoints
# IPython
profile_default/
ipython_config.py
# pyenv
.python-version
# celery beat schedule file
celerybeat-schedule
# SageMath parsed files
*.sage.py
# Environments
.env
.venv
env/
venv/
ENV/
env.bak/
venv.bak/
# Spyder project settings
.spyderproject
.spyproject
# Rope project settings
.ropeproject
# mkdocs documentation
/site
# mypy
.mypy_cache/
.dmypy.json
dmypy.json
Java项目
# Compiled class file
*.class
# Log file
*.log
# BlueJ files
*.ctxt
# Mobile Tools for Java (J2ME)
.mtj.tmp/
# Package Files #
*.jar
*.war
*.nar
*.ear
*.zip
*.tar.gz
*.rar
# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
hs_err_pid*
replay_pid*
# IDE
.idea/
*.iml
*.ipr
*.iws
.vscode/
.settings/
.project
.classpath
# Maven
target/
pom.xml.tag
pom.xml.releaseBackup
pom.xml.versionsBackup
pom.xml.next
release.properties
dependency-reduced-pom.xml
buildNumber.properties
.mvn/timing.properties
.mvn/wrapper/maven-wrapper.jar
# Gradle
.gradle
build/
!gradle/wrapper/gradle-wrapper.jar
!**/src/main/**/build/
!**/src/test/**/build/
# NetBeans
/nbproject/private/
/nbbuild/
/dist/
/nbdist/
/.nb-gradle/
# OS
.DS_Store
.DS_Store?
._*
.Spotlight-V100
.Trashes
ehthumbs.db
Thumbs.db
Web项目
# Logs
logs
*.log
npm-debug.log*
yarn-debug.log*
yarn-error.log*
# Runtime data
pids
*.pid
*.seed
*.pid.lock
# Coverage directory used by tools like istanbul
coverage/
*.lcov
# nyc test coverage
.nyc_output
# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
.grunt
# Bower dependency directory (https://bower.io/)
bower_components
# node-waf configuration
.lock-wscript
# Compiled binary addons (https://nodejs.org/api/addons.html)
build/Release
# Dependency directories
node_modules/
jspm_packages/
# TypeScript v1 declaration files
typings/
# Optional npm cache directory
.npm
# Optional eslint cache
.eslintcache
# Optional REPL history
.node_repl_history
# Output of 'npm pack'
*.tgz
# Yarn Integrity file
.yarn-integrity
# dotenv environment variables file
.env
.env.test
# parcel-bundler cache (https://parceljs.org/)
.cache
.parcel-cache
# next.js build output
.next
# nuxt.js build output
.nuxt
# vuepress build output
.vuepress/dist
# Serverless directories
.serverless
# FuseBox cache
.fusebox/
# DynamoDB Local files
.dynamodb/
# TernJS port file
.tern-port
# IDE
.idea/
.vscode/
*.swp
*.swo
*~
# OS
.DS_Store
.DS_Store?
._*
.Spotlight-V100
.Trashes
ehthumbs.db
Thumbs.db
C/C++项目
# Prerequisites
*.d
# Compiled Object files
*.o
*.ko
*.obj
*.elf
# Linker output
*.ilk
*.map
*.exp
# Precompiled Headers
*.gch
*.pch
# Libraries
*.lib
*.a
*.la
*.lo
# Shared objects (inc. Windows DLLs)
*.dll
*.so
*.so.*
*.dylib
# Executables
*.exe
*.out
*.app
*.i*86
*.x86_64
*.hex
# Debug files
*.dSYM/
*.su
*.idb
*.pdb
# Kernel Module Compile Results
*.mod*
*.cmd
.tmp_versions/
modules.order
Module.symvers
Mkfile.old
dkms.conf
# CMake
CMakeCache.txt
CMakeFiles/
cmake_install.cmake
Makefile
*.cmake
!CMakeLists.txt
# IDE
.vs/
.vscode/
.idea/
*.suo
*.ntvs*
*.njsproj
*.sln
*.swp
*.swo
*~
# OS
.DS_Store
.DS_Store?
._*
.Spotlight-V100
.Trashes
ehthumbs.db
Thumbs.db
不同操作系统下的忽略文件配置
不同的操作系统会产生不同的系统文件和临时文件，因此在配置忽略文件时需要考虑操作系统的差异。
Windows系统
在Windows系统下，通常需要忽略以下文件和目录：
# Windows image file caches
Thumbs.db
ehthumbs.db
# Folder config file
Desktop.ini
# Recycle Bin used on file shares
$RECYCLE.BIN/
# Windows Installer files
*.cab
*.msi
*.msm
*.msp
# Windows shortcuts
*.lnk
macOS系统
在macOS系统下，通常需要忽略以下文件和目录：
# General
.DS_Store
.AppleDouble
.LSOverride
# Icon must end with two \r
Icon
# Thumbnails
._*
# Files that might appear in the root of a volume
.DocumentRevisions-V100
.fseventsd
.Spotlight-V100
.TemporaryItems
.Trashes
.VolumeIcon.icns
.com.apple.timemachine.donotpresent
# Directories potentially created on remote AFP share
.AppleDB
.AppleDesktop
Network Trash Folder
Temporary Items
.apdisk
Linux系统
在Linux系统下，通常需要忽略以下文件和目录：
# Temporary files
*~
*.swp
*.swo
*.tmp
# Directory
.tmp/
.cache/
跨平台项目
对于跨平台项目，建议合并上述所有操作系统的忽略规则，以确保在任何平台上都不会有系统文件被误提交到版本库中。
使用命令行和图形界面工具配置忽略文件
SVN提供了多种方式来配置忽略文件，包括命令行工具和图形界面工具。下面将介绍几种常用的方法。
使用命令行工具配置忽略文件
使用svn propset命令
svn propset命令可以直接设置目录的svn:ignore属性：
# 设置单个忽略模式
svn propset svn:ignore "*.pyc" .
# 设置多个忽略模式
svn propset svn:ignore "*.pyc
__pycache__
*.log
.DS_Store" .
# 从文件中读取忽略模式
svn propset svn:ignore -F .svnignore .
使用svn propedit命令
svn propedit命令会打开一个文本编辑器，允许你交互式地编辑忽略模式：
# 编辑当前目录的忽略模式
svn propedit svn:ignore .
# 编辑指定目录的忽略模式
svn propedit svn:ignore path/to/directory
使用svn status命令查看未版本控制的文件
svn status命令可以显示工作副本中的未版本控制文件，这些文件可能是需要被忽略的：
# 显示所有未版本控制的文件
svn status
# 只显示未版本控制的文件
svn status | grep "^\?"
使用svn add命令添加文件时忽略匹配的文件
当使用svn add命令添加文件时，可以使用--no-ignore选项来覆盖忽略设置：
# 添加所有文件，包括被忽略的文件
svn add --no-ignore .
# 添加所有未版本控制的文件，但不包括被忽略的文件
svn add * --force
使用TortoiseSVN配置忽略文件
TortoiseSVN是Windows上一个流行的SVN客户端，它提供了图形界面来配置忽略文件。
使用TortoiseSVN设置忽略文件
在Windows资源管理器中，右键点击要设置忽略规则的目录
选择”TortoiseSVN” > “属性”
在”属性”对话框中，点击”新建” > “高级”
在”属性名称”下拉列表中选择”svn:ignore”
在”属性值”文本框中输入要忽略的文件模式，每行一个模式
点击”确定”保存设置
使用TortoiseSVN的”添加到忽略列表”功能
在Windows资源管理器中，右键点击要忽略的文件或目录
选择”TortoiseSVN” > “添加到忽略列表”
选择忽略方式：
“文件名.ext”：只忽略当前文件
”*.ext”：忽略所有具有相同扩展名的文件
“文件夹名”：忽略所有具有相同名称的文件夹
使用TortoiseSVN的”属性列表”功能
在Windows资源管理器中，右键点击要查看或修改忽略规则的目录
选择”TortoiseSVN” > “属性列表”
在”属性列表”对话框中，可以查看和编辑所有SVN属性，包括svn:ignore
使用其他图形界面工具配置忽略文件
除了TortoiseSVN，还有其他图形界面工具可以配置SVN忽略文件，如SmartSVN、RabbitVCS等。这些工具通常提供了类似于TortoiseSVN的功能，但界面和操作方式可能略有不同。
忽略文件的最佳实践
为了确保SVN忽略文件的配置既有效又易于维护，以下是一些最佳实践建议：
1. 针对项目定制忽略规则
不同的项目有不同的需求，应该根据项目的具体特点定制忽略规则。例如，Python项目应该忽略.pyc文件和__pycache__目录，而Java项目则应该忽略.class文件和target目录。
2. 使用项目特定的忽略文件
虽然全局忽略文件很方便，但项目特定的忽略文件更加灵活。建议在项目根目录设置svn:ignore属性，而不是依赖全局忽略文件。这样可以确保每个团队成员都有相同的忽略规则，无论他们的客户端配置如何。
3. 将忽略规则版本化
将忽略规则保存在项目中的一个文件（如.svnignore）中，并将该文件添加到版本控制中。这样可以确保忽略规则本身也被版本化，团队成员可以轻松地共享和更新这些规则。
# 创建忽略规则文件
echo "*.pyc
__pycache__
*.log
.DS_Store" > .svnignore
# 将忽略规则文件添加到版本控制
svn add .svnignore
svn commit -m "Add .svnignore file"
# 将忽略规则文件的内容设置为svn:ignore属性
svn propset svn:ignore -F .svnignore .
svn commit -m "Set svn:ignore property"
4. 定期审查和更新忽略规则
项目会随着时间的推移而发展，可能会产生新的需要忽略的文件类型。定期审查和更新忽略规则，确保它们仍然适用于当前的项目状态。
5. 使用注释提高可读性
在忽略规则文件中使用注释来解释为什么需要忽略某些文件或目录，这有助于团队成员理解忽略规则的目的。
# Python compiled files
*.pyc
__pycache__
# Log files
*.log
# macOS system files
.DS_Store
6. 避免忽略重要的文件
在设置忽略规则时，要确保不会意外地忽略重要的文件。例如，不要忽略配置文件、文档或测试数据，除非确定它们不应该被版本控制。
7. 使用版本化的构建输出目录
对于构建输出目录（如build/、dist/、target/等），可以考虑将空目录添加到版本控制中，而不是忽略它们。这样可以确保目录结构在所有团队成员的工作副本中保持一致。
# 创建并添加空的构建目录
mkdir -p build/dist
svn add build
svn commit -m "Add build directory"
# 设置svn:ignore属性，忽略构建目录中的内容
svn propset svn:ignore "*" build/dist
svn commit -m "Set svn:ignore property for build/dist directory"
8. 考虑使用svn:global-ignores属性
对于需要在整个项目中统一忽略的文件类型（如特定IDE的配置文件），考虑使用svn:global-ignores属性，而不是在每个目录中重复设置相同的svn:ignore属性。
# 设置全局忽略规则
svn propset svn:global-ignores "*.swp
*.swo
.vscode/" .
svn commit -m "Set svn:global-ignores property"
常见问题和解决方案
在配置和使用SVN忽略文件时，可能会遇到一些常见问题。下面将介绍这些问题及其解决方案。
问题1：已版本控制的文件不会被忽略
现象：即使设置了忽略规则，某些文件仍然显示在svn status的输出中。
原因：SVN的忽略规则只对未版本控制的文件有效。一旦文件被添加到版本控制中，忽略规则将不再对其生效。
解决方案：
如果文件不应该被版本控制，首先需要将其从版本控制中删除：
svn delete file.txt
svn commit -m "Remove file.txt from version control"
然后设置忽略规则，确保文件不会被重新添加：
svn propset svn:ignore "file.txt" .
svn commit -m "Set svn:ignore property"
如果需要在本地保留文件，可以使用--keep-local选项：
svn delete --keep-local file.txt
svn commit -m "Remove file.txt from version control"
问题2：忽略规则不生效
现象：设置了忽略规则，但文件仍然没有被忽略。
原因：可能有多种原因导致忽略规则不生效，如语法错误、属性设置位置不正确等。
解决方案：
检查忽略规则的语法是否正确：
svn propget svn:ignore .
确保属性设置在正确的目录上。忽略规则只对设置属性的目录及其直接子目录中的未版本控制文件有效。
如果使用svn:global-ignores属性，确保SVN客户端版本为1.8或更高。
检查是否有全局忽略规则覆盖了项目特定的忽略规则：
svn config get miscellany global-ignores
问题3：如何在多个目录中应用相同的忽略规则
现象：需要在项目的多个目录中应用相同的忽略规则，但不想在每个目录中单独设置。
解决方案：
使用svn:global-ignores属性（SVN 1.8+）：
svn propset svn:global-ignores "*.pyc
__pycache__
*.log" .
svn commit -m "Set svn:global-ignores property"
或者使用脚本来批量设置忽略规则：
“`bash
创建一个包含忽略规则的文件
echo “*.pyc
pycache
*.log” > .svnignore
# 在多个目录中设置相同的忽略规则
for dir in dir1 dir2 dir3; do
svn propset svn:ignore -F .svnignore $dir
done
svn commit -m “Set svn:ignore property in multiple directories”
### 问题4：如何忽略特定模式的目录
**现象**：需要忽略名称匹配特定模式的所有目录，而不仅仅是文件。
**解决方案**：
在忽略规则中，目录名应该以斜杠结尾：
```bash
svn propset svn:ignore "tmp/
build/
*.tmp/" .
svn commit -m "Set svn:ignore property for directories"
问题5：如何忽略除特定文件外的所有内容
现象：需要忽略目录中的所有内容，除了少数几个特定文件。
解决方案：
SVN不支持”白名单”模式的忽略规则，但可以通过以下方式实现类似效果：
首先忽略目录中的所有内容：
svn propset svn:ignore "*" config/
svn commit -m "Ignore all content in config directory"
然后显式添加需要版本控制的文件：
svn add config/settings.xml --no-ignore
svn commit -m "Add settings.xml to version control"
问题6：如何处理已经被忽略的文件需要版本控制的情况
现象：某个文件之前被忽略了，现在需要将其添加到版本控制中。
解决方案：
使用--no-ignore选项来覆盖忽略规则：
svn add file.txt --no-ignore
svn commit -m "Add file.txt to version control"
问题7：如何在不同操作系统之间共享忽略规则
现象：团队成员使用不同的操作系统，需要确保忽略规则在所有平台上都有效。
解决方案：
创建一个包含所有平台相关忽略规则的文件，并将其添加到版本控制中：
# 创建跨平台忽略规则文件
cat > .svnignore << EOF
# Python
*.pyc
__pycache__/
# Logs
*.log
# macOS
.DS_Store
.DS_Store?
._*
.Spotlight-V100
.Trashes
# Windows
Thumbs.db
ehthumbs.db
Desktop.ini
# Linux
*~
*.swp
*.swo
EOF
# 将忽略规则文件添加到版本控制
svn add .svnignore
svn commit -m "Add cross-platform .svnignore file"
# 应用忽略规则
svn propset svn:ignore -F .svnignore .
svn commit -m "Set svn:ignore property"
问题8：如何查看哪些文件被忽略了
现象：想要查看当前目录中有哪些文件被忽略了。
解决方案：
使用svn status命令的--no-ignore选项：
# 显示所有未版本控制的文件，包括被忽略的文件
svn status --no-ignore | grep "^\?"
# 显示被忽略的文件
svn status --no-ignore | grep "^I"
总结
SVN的忽略文件功能是保持版本库整洁和高效的重要工具。通过合理配置忽略规则，可以避免不必要的文件被提交到版本库中，从而减少版本库的体积，提高版本控制的效率，并使团队协作更加顺畅。
本文详细介绍了SVN中配置忽略文件的各种方法，包括全局忽略文件和项目特定忽略文件的配置，常见需要忽略的文件类型和模式，不同操作系统下的忽略文件配置，以及使用命令行和图形界面工具配置忽略文件的方法。此外，还提供了一些最佳实践建议和常见问题的解决方案，帮助开发者更好地管理SVN版本库。
通过遵循本文中的指导，开发者可以有效地配置SVN忽略文件，确保只有真正需要版本控制的文件被提交到版本库中，从而保持代码库的整洁和高效。无论是个人项目还是团队协作，合理使用SVN的忽略文件功能都能带来显著的好处。