你在Source Insight里遇到文件后缀不识别，常见表现是文件列表里看不到目标文件，或者能打开但没有语法高亮和符号信息，搜索与跳转也不工作。多数情况下并不是文件坏了，而是Source Insight按文件类型过滤显示与收录，后缀不在已知类型里就会被当成未知文件处理，因此要先把识别链路打通，再补齐后缀映射与索引刷新。

　　一、Source Insight文件后缀不识别怎么办

　　排查时先确认它到底是显示被过滤，还是确实没有被归类到任何文件类型。把这两件事分开，你就能快速判断应该改映射规则，还是只需要把文件加入项目并同步索引。

　　1、先确认文件是否被已知类型过滤掉

　　打开【Project】→【Add and Remove Project Files】，检查列表里是否勾选了只显示已知文档类型的选项，如果勾选会导致未知后缀的文件在选择列表里直接消失，先取消勾选再看文件是否出现。

　　2、在编辑窗口里核对当前文件被判定成什么类型

　　先把目标文件打开，在编辑窗口右键选择【File Type Options】或从【Options】进入【File Type Options】，观察弹窗里自动选中的文件类型名称，若显示为未知或不匹配，说明后缀映射需要补。

　　3、确认该文件类型是否允许被加入项目

　　在【File Type Options】里选中对应类型，查看是否启用了Include when adding to projects这类控制项，如果未启用，Source Insight在自动加文件或列表展示时会排除该类型，导致你以为后缀不识别。

　　4、如果你用的是Source Insight 3系列先走【Document Options】检查过滤规则

　　进入【Options】→【Document Options】，选中你希望归类到的文档类型，检查File Filter里是否包含目标后缀通配符，很多时候只需要把新的后缀追加进去即可。

　　5、遇到无后缀文件先按文件名做匹配再谈解析

　　像Makefile这类无后缀文件，不能只靠扩展名匹配，需要在文件类型过滤里增加按文件名匹配的规则，让Source Insight先把它识别进来，否则文件列表与自动收录都会漏掉。

　　二、Source Insight后缀映射规则怎么添加

　　映射规则的本质是把某个后缀或文件名通配符归到一个文件类型，并指定该类型使用的语言解析器与显示编辑选项。做法上建议优先复用现有类型并追加后缀，只有在语法差异很大时才新增类型。

　　1、用【File Type Options】定位到你要扩展的文件类型

　　打开任意一个同语言的已识别文件，在编辑窗口右键点【File Type Options】，这样弹窗会自动选中当前文件所属类型，你可以直接在这个类型上追加新的后缀规则。

　　2、在File Filter里追加你的后缀通配符并用分号分隔

　　把原有过滤串保留，在末尾追加你的规则，例如把*.c和*.h扩展为*.c;*.h;*.h2这种形式，保持分隔符一致，避免把通配符写成逗号或空格导致匹配失效。

　　3、需要新增类型时用Add Type并把解析语言选对

　　在【File Type Options】里点Add Type新建类型，先给类型起一个能区分用途的名称，再把File Filter填好，最后把Language设置成与你代码一致的语言解析器，否则即便文件能显示出来，符号与跳转也可能不完整。

　　4、把新类型勾选为可加入项目避免后续自动收录失败

　　在新建或修改的类型里，启用Include when adding to projects相关选项，让它既能在添加文件对话框里出现，也能在自动同步时被纳入项目，否则规则加了但项目仍然不收录。

　　5、用Source Insight 3系列时在【Document Options】里直接改列表更快

　　进入【Options】→【Document Options】，选择目标文档类型，在File Filter里追加新的通配符并保存，Source Insight 3会按这些通配符把文件归类到对应文档类型。

　　6、改完映射后立刻回到加文件界面验证匹配是否生效

　　打开【Project】→【Add and Remove Project Files】，先勾回只显示已知文档类型的选项，再观察你的新后缀文件是否能被正常列出并可加入，这一步能最快确认映射规则是否写对。

　　三、Source Insight索引更新与显示恢复

　　后缀映射加完仍然看不到符号信息，往往是项目数据库还没重新解析这些文件，或者文件虽然加入了但没有触发同步。把同步与重建放进固定动作里，你就能把显示与索引问题一次性收口。

　　1、先用【Project】→【Synchronize Files】让新规则触发重新解析

　　执行【Project】→【Synchronize Files】，让Source Insight扫描项目文件并更新符号数据库，必要时启用忽略时间戳的选项来强制更新全部文件，适合你刚大批量改了文件类型规则的场景。

　　2、出现符号库异常或改动过大时用【Project】→【Rebuild Project】重建

　　当你怀疑数据文件不一致，或映射调整后仍然表现怪异，直接执行【Project】→【Rebuild Project】让项目数据从头重建，这个动作会促使所有文件重新被解析。

　　3、检查后台同步是否开启避免你以为已更新其实没更新

　　进入【Options】→【Preferences】里与General相关的同步设置，确认后台同步功能处于启用状态并设置了合理的检查间隔，这样日常新增文件或改动不会长期处于未解析状态。

　　4、确认文件确实被加入项目而不是只在磁盘上存在

　　如果文件只存在于目录树但没有进入项目文件列表，即使后缀映射正确也不会产生符号索引，回到【Project】→【Add and Remove Project Files】把目录树重新Add Tree或Add All一次，再同步索引。

　　总结

　　解决Source Insight文件后缀不识别，核心是先排除文件列表过滤与类型未允许加入项目这两类原因，再在【File Type Options】或【Document Options】里把后缀通配符追加到正确的类型中，最后用【Synchronize Files】或【Rebuild Project】把索引更新跑一遍，让显示、解析与跳转在同一口径下恢复正常。