Source Insight怎么设置项目文件过滤规则 Source Insight项目中出现无关文件如何调整过滤条件

Source Insight建立大型代码工程时，可以根据File Type决定哪些文件会被自动加入项目。源码目录里同时包含编译产物、脚本、配置文件、第三方资源或临时文件时，如果过滤范围设置过宽，【Add Tree】或自动同步就可能把不需要分析的文件一起加入Project File List。处理这类问题时，可以先通过File Type Options控制文件扩展名，再清理已经进入工程的无关文件；如果还需要严格限定目录和具体文件，则可以使用Master File List维护项目范围。

一、Source Insight怎么设置项目文件过滤规则

Source Insight主要根据文件名和扩展名识别File Type，每种File Type都可以决定是否在添加项目文件时参与扫描。因此，不需要单独编写复杂的排除表达式，也可以先通过文件类型控制大部分工程文件。

1、通过File Type Options设置文件过滤

①打开当前Source Insight工程。

②进入【Options】→【File Type Options】。

③在【File Type】中选择需要调整的类型，例如【C/C++Source File】。

④找到【File Filter】。

⑤检查当前匹配规则，例如【.c;.h;*.cpp】。

⑥项目还有需要解析的自定义扩展名时，把对应规则加入File Filter。

⑦不希望某种File Type自动加入项目时，取消【Include when adding to project】。

⑧点击【OK】保存设置。

【File Filter】支持使用文件名和通配符定义文件类型，例如项目使用【*.cc】作为C++源码，但现有规则没有包含它，就可以把该扩展名加入C/C++Source File。这里定义的不只是文件显示方式，也会影响Source Insight给文件使用什么语言解析器。

2、添加目录时只加入已知文件类型

①进入【Project】→【Add and Remove Project Files】。

②选择准备加入项目的源码目录。

③勾选【Show only known file types】。

④检查左侧文件列表中是否只剩需要的源码和文本文件。

⑤需要加入当前目录时使用【Add All】。

⑥需要递归加入完整源码目录时选择【Add Tree】。

⑦确认Source Insight提示加入子目录时，根据项目实际范围继续操作。

⑧加入后查看右侧【Project Files】列表。

开启【Show only known file types】以后，Source Insight会结合File Type定义以及【Include when adding to project】过滤文件，比关闭该选项后直接把整个目录树加入项目更适合源码工程。

3、使用Master File List严格控制工程范围

①进入【Project】→【Project Settings】。

②找到【Project Source Files】。

③选择【Use a Master File List】。

④指定Master File List文件。

⑤已有工程可以先执行【Project】→【Export Project File List】生成初始列表。

⑥再打开【Project】→【Open Project Master File List】。

⑦在列表中保留真正需要分析的文件或目录。

⑧保存Master File List。

⑨等待Source Insight重新同步工程。

Master File List可以填写具体文件、通配符和目录，适合源码目录结构复杂，但实际只需要其中部分模块的项目，也方便团队成员共享相同的项目文件范围。

二、Source Insight项目中出现无关文件如何调整过滤条件

已经进入项目的无关文件不会因为修改File Filter就一定立即消失。File Type Options主要影响后续添加和自动扫描，所以调整过滤条件以后，还需要清理Project File List中已经存在的文件。

1、批量删除已有无关文件

①打开【Project】→【Add and Remove Project Files】。

②在【Project Files】中查看当前项目文件。

③找到不需要的文件类型。

④选中单个或多个无关文件。

⑤点击【Remove File】。

⑥需要按规则批量删除时点击【Remove Special】。

⑦按照文件名或扩展名筛选，例如删除某类临时文件。

⑧确认后关闭窗口。

从Source Insight项目中Remove文件只会删除项目引用和对应符号信息，不会把磁盘上的原始文件直接删除，因此可以放心用于清理工程索引范围。

2、检查是不是自动同步重新加入文件

有些文件刚删除，过一段时间又重新出现在项目里，这时应检查自动添加机制，而不是反复手工Remove。

①进入【Project】→【Synchronize Files】。

②查看【Add new files automatically】是否启用。

③如果不希望同步过程中自动发现新文件，可以关闭该选项。

④再进入【Options】→【Preferences】。

⑤打开【General】相关设置。

⑥检查后台Project Synchronization配置。

⑦确认自动同步是否同时允许添加新文件。

⑧修改后重新执行一次【Synchronize Files】。

自动添加开启后，Source Insight会在已有Project File所在目录及其子目录中寻找新文件，因此构建工具后来生成的新源码、脚本或其他已知类型文件也可能进入项目。

3、处理某种扩展名全部不需要的情况

①进入【Options】→【File Type Options】。

②选择无关文件对应的File Type。

③确认项目是否完全不需要这一类型。

④取消【Include when adding to project】。

⑤返回【Add and Remove Project Files】。

⑥使用【Remove Special】清除已经加入的该类型文件。

⑦重新执行【Synchronize Files】。

⑧确认文件没有再次进入Project File List。

如果只是不需要某个目录中的同类型文件，不建议直接关闭整个File Type，否则其他源码目录中真正需要的相同扩展名也会被过滤掉。

三、过滤后仍有多余文件怎么继续限制项目范围

当源码树中同一种扩展名既有需要分析的文件，也有必须排除的文件时，仅依靠File Type就不够精确。这时应从目录范围或Master File List控制，而不是继续修改全局扩展名。

1、缩小Add Tree的目录范围

①打开【Add and Remove Project Files】。

②不要直接选择整个仓库根目录。

③只定位到实际源码目录，例如【src】或具体模块目录。

④勾选【Show only known file types】。

⑤执行【Add Tree】。

⑥对测试代码或第三方目录按需要分别决定是否加入。

这样可以避免把build、docs、tools等与源码放在同一仓库中的目录全部扫描进工程。

2、用Master File List限定具体目录

①打开当前Master File List。

②检查里面是否直接加入了过大的根目录。

③把根目录改成真正需要的子目录。

④需要某一类文件时使用通配规则。

⑤只需要个别文件时直接填写具体相对路径。

⑥保存文件。

⑦执行【Synchronize Files】检查Project File List变化。

Master File List变化后，Source Insight会按照列表重新协调项目文件，列表中不存在的项目文件也可以被移出当前工程。

3、过滤完成后重新同步符号数据

①进入【Project】→【Synchronize Files】。

②确认项目文件范围已经正确。

③需要重新解析全部保留文件时启用【Force all files to be re-parsed】。

④执行同步。

⑤查看【Project File List】。

⑥再测试【Jump to Definition】【Lookup References】和Relation Window。

过滤无关文件以后重新解析，可以让项目符号数据库只围绕实际需要的源码建立，减少同名函数、第三方代码和生成文件对符号查找结果的干扰。

总结

Source Insight设置项目文件过滤时，可以先通过File Type Options中的File Filter和Include when adding to project控制哪些文件类型参与项目扫描，再利用Add and Remove Project Files清理已经加入的无关文件。如果同一种扩展名在不同目录中既有需要保留的文件又有无关文件，则更适合缩小Add Tree范围或使用Master File List精确维护项目内容。调整完成后重新同步工程，可以让文件列表和符号数据库保持一致。如需进一步了解Source Insight项目文件过滤、工程文件管理与项目同步设置方法，欢迎联系咨询。