SVN ignore 设置详解

SVN Ignore 设置详解：掌控你的版本控制

Subversion (SVN) 是一款广受欢迎的集中式版本控制系统，它能够帮助团队有效地管理代码、文档和其他项目文件。然而，并非所有文件都需要纳入版本控制。一些文件，例如编译生成的中间文件、临时文件、个人配置文件等，不仅占用宝贵的存储空间，还会增加版本库的负担，甚至引发不必要的冲突。为了避免这种情况，SVN 提供了强大的 svn ignore 功能，允许用户指定哪些文件或目录应该被版本控制系统忽略。本文将深入探讨 svn ignore 的各种用法，帮助你精细掌控你的版本控制流程。

1. 忽略文件的几种方式:

SVN 提供了多种方式来忽略文件，每种方式都有其适用的场景：

• 全局忽略模式 (Global ignores): 全局忽略模式定义在客户端配置文件 ~/.subversion/config 中的 global-ignores 选项下。它对所有 SVN 工作副本生效，通常用于忽略特定类型的文件，例如 .o、.class、*.tmp 等。需要注意的是，全局忽略模式只对新添加的文件生效，对于已纳入版本控制的文件，需要先将其从版本控制中移除。

• 每个仓库的忽略模式 (Repository properties): 这种方式将忽略模式设置在仓库的 svn:ignore 属性上，对所有检出该仓库的开发者生效。它适用于特定项目需要忽略的文件或目录，例如编译输出目录 bin、测试数据目录 test-data 等。这种方式的优点是所有开发者共享相同的忽略规则，确保一致性。

• 本地忽略模式 (Local .svn/dir-prop-base): 本地忽略模式存储在 .svn/dir-prop-base 文件夹中，不会提交到版本库，只对当前工作副本生效。它适用于特定开发者需要忽略的个人文件或目录，例如 IDE 的配置文件 .idea、.vscode 等。

2. 设置忽略模式:

• 全局忽略模式: 编辑 ~/.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

• 仓库忽略模式: 可以使用 svn propset 命令设置仓库的 svn:ignore 属性。例如，要忽略 bin 和 obj 目录：

bash
svn propset svn:ignore "bin
obj" .
svn commit -m "Add ignore properties for bin and obj directories"

注意：这里使用了多行字符串，确保每个目录占一行。也可以使用 -F 参数从文件中读取忽略模式。

• 本地忽略模式: 最简单的方法是使用 svn ignore 命令。例如，要忽略 temp.txt 文件：

bash
svn ignore temp.txt

这等效于手动编辑 .svn/dir-prop-base 文件。

3. 忽略模式的语法:

SVN 的忽略模式使用通配符，类似于 shell 的文件名匹配规则：

• * 匹配任意字符序列（包括空序列）。
• ? 匹配单个字符。
• [] 匹配字符集中的任意一个字符，例如 [abc] 匹配 a、b 或 c。可以使用 - 表示范围，例如 [a-z] 匹配所有小写字母。
• ^ 位于字符集开头表示取反，例如 [^abc] 匹配除 a、b、c 以外的任何字符。

4. 一些常用的忽略模式:

• 编译输出: *.o *.class *.dll *.exe bin obj target
• 临时文件: *.tmp *~ #*# .#* temp.*
• 编辑器备份: *.bak *.swp .*.swp
• IDE 配置: .idea .vscode .project .settings
• 操作系统文件: .DS_Store Thumbs.db

5. 高级用法:

• 取消忽略: 要取消忽略某个文件或目录，可以使用 svn revert 命令恢复其属性：

bash
svn revert --depth=infinity .

然后重新设置 svn:ignore 属性，移除不需要忽略的模式。

• 递归应用忽略模式: 使用 --depth 参数可以控制 svn propset 命令的作用范围。例如，要将忽略模式递归应用到所有子目录：

bash
svn propset svn:ignore -F ignore-list.txt --depth=infinity .

• svn status 的 I 标志: svn status 命令会使用 I 标志表示被忽略的文件。

6. 最佳实践:

• 尽早设置忽略模式: 在项目初期就设置好合适的忽略模式，可以避免后期清理的麻烦。
• 使用 svn:ignore 属性: 尽量使用 svn:ignore 属性，确保团队成员共享相同的忽略规则。
• 定期 review 忽略模式: 随着项目的演进，可能需要调整忽略模式，定期 review 可以保持其有效性。
• 文档化忽略模式: 在项目文档中记录忽略模式的设置，方便团队成员理解和维护。

7. 总结:

svn ignore 是 SVN 中一个非常重要的功能，它可以帮助你保持版本库的清洁和高效。通过理解和灵活运用各种忽略模式设置方法，你可以更好地掌控你的版本控制流程，提高团队的协作效率。 合理配置 .subversion/config 文件，配合 svn propset 和 svn ignore 命令，以及清晰的忽略模式语法理解，将帮助你构建一个干净、高效的版本控制环境，使团队专注于核心代码的开发和维护，避免不必要的干扰。 记住，一个良好配置的 SVN 忽略设置，是高效软件开发的基石之一。