在使用 SVN（Subversion）进行版本控制时，经常会遇到一些不需要纳入版本控制的文件夹或文件，例如编译生成的临时文件、日志文件、本地配置文件等，SVN 提供了忽略特定文件或文件夹的功能，通过配置 svn:ignore 属性来实现，本文将详细介绍 SVN 忽略文件夹的命令、操作步骤、注意事项以及常见问题解决方法。

SVN 忽略文件夹的基本原理

SVN 的忽略功能是通过在版本库的特定目录上设置 svn:ignore 属性来实现的。svn:ignore 属性的值是一个模式列表，匹配这些模式的文件或文件夹不会被 SVN 跟踪，需要注意的是，svn:ignore 只对未纳入版本控制的文件或文件夹生效，已经提交到版本库的文件或文件夹即使被添加到忽略列表，仍会被 SVN 继续跟踪。

SVN 忽略文件夹的命令与操作步骤

设置忽略属性

使用 svn propset 命令可以为当前目录或指定目录设置 svn:ignore 属性，基本语法如下：

svn propset svn:ignore '忽略模式列表' 目录路径

要忽略当前目录下的 target 文件夹（常见于 Maven 项目的编译输出目录），可以执行：

svn propset svn:ignore 'target' .

如果要忽略多个文件夹或文件,可以在 svn:ignore 的值中用换行符分隔。

svn propset svn:ignore -F ignore_list.txt .

ignore_list.txt 文件的内容如下：

target
logs
temp
*.log

查看忽略属性

使用 svn propget 命令可以查看某个目录的 svn:ignore 属性值：

svn propget svn:ignore 目录路径

查看当前目录的忽略设置：

svn propget svn:ignore .

编辑忽略属性

如果需要修改忽略列表,可以使用 svn propedit 命令，它会打开一个文本编辑器（如 vim 或记事本）供用户编辑忽略模式：

svn propedit svn:ignore 目录路径

svn propedit svn:ignore .

编辑完成后保存即可。

递归设置忽略属性

如果需要为当前目录及其所有子目录设置相同的忽略规则,可以使用 --recursive 参数：

svn propset svn:ignore '忽略模式' 目录路径 --recursive

但需要注意,递归设置可能会覆盖子目录已有的 svn:ignore 属性，因此建议仅在必要时使用。

删除忽略属性

如果需要移除某个目录的 svn:ignore 属性，可以使用 svn propdel 命令：

svn propdel svn:ignore 目录路径

SVN 忽略文件夹的注意事项

1. 仅对未跟踪文件生效：svn:ignore 只对 SVN 状态为 （未纳入版本控制）的文件或文件夹生效，如果已经提交的文件需要被忽略，需要先使用 svn delete 删除并提交，再设置忽略属性。

2. 忽略模式的语法：忽略支持通配符，如 （匹配任意字符）、（匹配单个字符）、[abc]（匹配字符集中的任意字符）等。

   • *.log：忽略所有 .log 文件。
   • temp*：以 temp 开头的文件夹或文件。
   • [0-9]：匹配单个数字。

3. 目录级别的独立性：svn:ignore 属性是按目录独立设置的，项目根目录忽略 target，子目录中如果有同名的 target，仍需要单独设置忽略规则。

4. 与 .svnignore 文件的区分：SVN 没有 .svnignore 文件（这是 Git 的用法），忽略规则必须通过 svn:ignore 属性设置。

常见操作场景示例

场景1：忽略单个文件夹

假设项目中有 build 文件夹需要忽略，操作步骤如下：

svn propset svn:ignore 'build' .
svn commit -m "添加 build 文件夹到忽略列表"

场景2：忽略多个文件和文件夹

需要忽略 logs、temp 文件夹以及所有 .class 文件：

svn propset svn:ignore -F ignore_list.txt .
svn commit -m "添加忽略规则：logs、temp 和 .class 文件"

场景3：递归忽略所有子目录的 node_modules（前端项目）

svn propset svn:ignore 'node_modules' . --recursive
svn commit -m "递归忽略所有子目录的 node_modules"

相关问答 FAQs

问题1：为什么设置了 svn:ignore 后，某些文件或文件夹仍被 SVN 跟踪？
解答：通常有两种原因：

1. 文件或文件夹已经提交到版本库。svn:ignore 只对未跟踪的文件生效，需要先删除并提交，再设置忽略规则。
2. 忽略模式不匹配,检查 svn:ignore 的值是否正确，例如大小写是否敏感、通配符是否使用正确，可以使用 svn status --no-ignore 查看所有未被忽略的文件。

问题2：如何批量导出和导入 SVN 的忽略规则？
解答：

• 导出忽略规则：使用 svn propget 将忽略规则保存到文件：

  svn propget svn:ignore . > ignore_rules.txt

• 导入忽略规则：使用 svn propset 从文件导入：

  svn propset svn:ignore -F ignore_rules.txt .

• 递归导出所有子目录的忽略规则：

  find . -name .svn -prune -o -exec svn propget svn:ignore {} \; > all_ignore_rules.txt

  注意：递归导入时需谨慎，避免覆盖子目录的现有规则。