Source Insight项目文件怎么同步 Source Insight项目文件更新后为什么搜索不到新代码

Source Insight项目文件的同步，以及项目文件更新后为什么搜索不到新代码，是维护C、C++这类大型工程的时候，经常会碰到的问题。Source Insight并不是简单地按照磁盘目录去实时搜索所有的文件，它会维护一份项目文件的列表和符号数据库。新代码如果没有被加入项目，或者文件更新以后没有被重新解析，那么搜索、符号跳转和调用关系，就有可能会看不到最新的内容。Source Insight的同步功能，会去扫描项目的文件，更新那些已经被修改过的文件的符号数据库，并且移除那些已经不在项目里的文件。

一、Source Insight项目文件怎么同步

在进行项目文件同步的时候，需要先分清楚“磁盘上有文件”和“Source Insight项目里有文件”，这两件事情并不是一回事。代码仓库更新以后，文件虽然已经出现在了本地的目录里面，但是如果没有被加入到项目文件的列表里去，Source Insight在搜索的时候，依然有可能是找不到的。

1、先执行项目的同步

通过【Project】菜单里的【Synchronize Files】，去重新同步当前项目的文件，和符号数据库。

这一步，比较适合用在代码刚从Git、SVN或者是压缩包这些地方更新完以后。同步完成了以后，Source Insight会重新去检查项目当中文件的变化，并且对那些被修改过的文件，更新它的符号信息。对于那些已经被删除的文件，也会从项目当中把它们给移除掉，避免在搜索结果里面，还残留着旧文件的信息。

2、检查新文件是不是被加入了项目

如果同步以后，依然是搜索不到新的代码，那就要去看一看，新的文件是不是已经属于当前的这个项目了。Source Insight的项目，从本质上来说，是一个源文件的集合，新的文件出现在目录当中以后，是可以通过Synchronize Files，或者是后台的同步，被加入到项目里面去的。要是这个项目，并没有把对应的目录或者文件类型包含进去，那么即便做了同步，也不一定就能把它纳入到搜索的范围里面去。

3、在必要的时候，用手动的方式去添加目录

通过【Add and Remove Project Files】这个功能，把新增的源码目录、头文件的目录，或者是整个源代码的目录树，都加入到项目里面来。

这个功能，比较适合用来一次性添加大量的文件、目录树，或者是那些被遗漏掉的源码目录。在Source Insight的资料里面也说明了，这个命令可以用来往当前的项目里面，去添加或者移除源文件，也可以用来添加整个源文件的目录树。

二、Source Insight项目文件更新后为什么搜索不到新代码

当搜索不到新代码的时候，不要马上去怀疑是不是搜索功能坏掉了。更加常见的原因，是新文件没有被加入到项目里面来、符号数据库没有被更新、文件的类型被过滤掉了，又或者是当前搜索的范围选错了。

1、文件并不在当前的项目里面

如果代码文件仅仅是放在了磁盘的目录里面，但是并没有进入项目文件的列表，那么项目搜索和符号跳转，都有可能找不到它。特别是那些新增的模块、新增的目录、外部的库，或者是自动生成的文件，这一类是最容易出现这种情况的。可以先在项目的窗口里面，去找一下文件的名字，确认一下它是不是真的已经被项目给管理起来了。

2、符号数据库没有被刷新

有些时候，文件是能够被搜索到的，但是函数、宏、变量却跳转不过去，这就说明文件有可能是在项目里面的，但是符号的解析，却还没有被更新。到了这个时候，可以去重新执行一下Synchronize Files，在必要的时候，把项目的数据库重新建立一遍。大型的项目，同步的时间会比较长，但是这个做法，要比只靠手动去打开文件，更加可靠一些。

3、文件类型或者搜索的范围不对

Source Insight有可能并没有把某一些扩展名，当成源码来处理，比如自定义的后缀、模板文件、脚本文件，或者是生成文件。如果在搜索的时候，只选择了当前的文件、当前的目录，或者是特定的文件类型，那也是会把新代码给漏掉的。碰到这种情况，需要去检查一下文件类型的设置，还有搜索的范围，而不是只在那里重复地去搜索那几个关键词。

三、Source Insight同步后还要检查哪些细节

项目的同步完成了以后，最好是再去做一次简单的确认。有不少的问题，并不是同步这个动作没有被执行，而是项目的路径、文件的列表，还有符号的解析，这几样没有被完全地对齐。特别是那种多人一起协作的项目，目录的结构是经常会发生变化的，Source Insight旧的项目文件，很容易就跟不上仓库的变化了。

1、确认项目的根目录是不是正确的

如果项目的根目录被建错了，或者是仓库被移动过位置，那么Source Insight就很有可能还在引用那个旧的路径。搜索的时候，看起来好像是在当前的工程里面去查，可实际上，项目的文件却是来自另外一个目录的。可以去检查一下项目里面文件的路径，确认一下它们是不是指向了当前的代码仓库。

2、把无效的旧文件清理掉

在仓库被重构了以后，旧的文件可能已经从磁盘上面被删除了，但是项目数据库里面，却还残留了一段时间。同步这个操作，是可以把那些已经不存在的项目文件给移除掉的，但是如果项目本身比较乱，那也可以用手动的方式，去检查一下文件的列表，把那些无效的目录给清掉，免得在搜索结果里面，混进去了旧的代码。

3、重新建立一个项目，会更加稳妥一些

如果项目的文件长期没有被维护，目录的结构变化又很大，或者是在同步以后，搜索依然是异常的，那就可以去考虑重新建立一个Source Insight的项目，然后再去重新添加源码的目录。新的项目，虽然会需要花上一段时间去建立索引，但是它能够避免旧的数据库、旧的路径，还有旧的文件列表，继续去干扰分析的结果。

总结

Source Insight项目文件应该怎样去同步，以及项目文件更新以后，为什么搜索不到新的代码，这里面的关键，是要理解Source Insight它是依赖于项目文件的列表，还有符号数据库的。在代码更新了以后，要先去执行Synchronize Files，然后再去确认新的文件是不是已经被加入了项目、文件的类型是不是被识别了、搜索的范围是不是正确的。要是目录的变化比较大，那还要去检查项目的根目录，还有旧文件的残留。只有把项目文件，和磁盘上面的源码同步好了，搜索、跳转，还有符号的分析，才会恢复正常。