SVN中忽略文件怎么设置

SVN忽略文件的设置方法

一 核心概念与适用范围

• svn:ignore：目录级别的 Subversion 属性，只对当前目录下未纳入版本控制的条目生效；已纳入版本控制的文件/目录不会被忽略。需要对该目录执行 svn propset/svn propedit 并提交属性变更后生效。
• global-ignores：客户端全局配置，对本机所有项目生效，作用于未纳入版本控制的条目；不会提交到仓库，也不影响他人。
• 常用命令速览：
  • 查看属性：svn proplist -v .
  • 编辑属性：svn propedit svn:ignore <目录>（需先设置 SVN_EDITOR）
  • 直接设值：svn propset svn:ignore “pattern” <目录>
  • 按文件设值：svn propset svn:ignore -F ignore.txt <目录>
  • 递归设置：svn propset svn:ignore -R “pattern” <目录>
  • 删除属性：svn propdel svn:ignore <目录>
  • 查看被忽略项：svn status --no-ignore（正常状态不显示被忽略项）
    以上要点与命令用法见多篇实践文档与教程说明。

二 命令行设置步骤

• 忽略某个未纳入版本控制的文件（如当前目录下的 test.php）
  1. 确认状态：svn status（应显示为 ? test.php）
  2. 设置编辑器（示例用 vim）：export SVN_EDITOR=vim
  3. 编辑忽略列表：svn propedit svn:ignore .，在编辑器中写入一行：test.php
  4. 提交属性：svn ci -m “Ignore test.php”
• 忽略某个未纳入版本控制的目录（如 cache）
  • 推荐：svn propset svn:ignore “cache” .（注意：忽略目录时不要加斜杠或尾部斜杠）
  • 若需忽略其下全部内容：svn propset svn:ignore “*” cache
• 忽略多种类型（一次写入多行或使用文件）
  • 多行写法：

    svn propset svn:ignore -F - . <<'EOF'
    *.class
    *.apk
    Thumbs.db
    EOF
    

  • 或多次设置并使用 -R 递归到子目录（注意多次设置会覆盖，建议一次性写入全部规则）
• 已纳入版本控制的条目如何处理
  • 仅忽略其内容而保留目录：先导出内容、再删除目录、提交删除、还原目录、设置 svn:ignore “*” <目录> 并提交属性。
  • 彻底不再跟踪：直接 svn rm <条目> 并提交。
    以上步骤与注意事项（如目录忽略不加斜杠、已纳入版本控制的条目不能直接忽略等）均有示例与说明。

三 图形化工具设置

• TortoiseSVN
  • 忽略单个条目：在资源管理器中右键该未纳入版本控制的文件/目录 → TortoiseSVN → Add to Ignore List → 选择忽略该文件/同扩展名/同目录。
  • 全局忽略：右键任意位置 → TortoiseSVN → Settings → Global ignore pattern，添加如 *.class、node_modules 等模式（空格分隔，支持通配符）。
• Eclipse Subversive/Subclipse
  • 全局忽略：Window → Preferences → Team → Ignored Resources → Add Pattern…
  • 目录级忽略：在 Package Explorer 中选中未纳入版本控制的条目 → Team → Add to SVN:ignore。
    上述图形化操作与入口在多篇教程中有图文说明。

四 全局忽略与常见模式

• 配置方式
  • 配置文件路径：~/.subversion/config（Windows 通常在用户目录下，如 %APPDATA%\Subversion\config）。
  • 找到 [miscellany] 段，取消注释并设置 global-ignores，例如：

    [miscellany]
    global-ignores = *.o *.so *.a *.pyc __pycache__ .DS_Store [Tt]humbs.db
    

  • 保存后对新检出的工作副本生效；已存在的工作副本需重新检出或确保未纳入版本控制的条目符合新模式。
• 模式语法要点
  • * 匹配任意长度字符串，? 匹配单个字符，[…] 字符集匹配；匹配默认区分大小写。
  • 目录忽略不要加前导或尾随斜杠（如写 bin，不要写 /bin 或 bin/）。
  • 查看被忽略项可用：svn status --no-ignore。
    以上配置方法与语法要点在实践文档中有明确示例与解释。

五 常见场景与推荐规则

• Maven 项目：忽略 target、.settings、.project、.classpath 等生成或 IDE 配置文件。
• 通用开发产物：忽略 ***.o *.so .a .pyc pycache .DS_Store [Tt]humbs.db 等。
• Windows 常见：Thumbs.db、Desktop.ini 等。
• 建议做法：将项目级规则写入各目录的 svn:ignore 并提交到仓库，同时配合本机 global-ignores 做个人级补充。
  这些规则在多篇教程中被反复采用，适用于大多数项目与团队环境。