Source Insight书签怎么添加 Source Insight书签丢失后怎么恢复定位

Source Insight函数跳转的设置，以及函数跳转到了声明那里却不能进入定义的处理，在查看C/C++项目的时候，是一个经常会碰到的问题。Source Insight的跳转功能需要依靠项目的符号库，只有当源文件、头文件、包含路径和符号同步这几样都保持正常，函数跳转的结果才会比较准确；这个软件本身支持通过快捷键或者鼠标的方式跳转到符号的定义，也支持在项目符号列表里面查找函数定义，并完成跳转。

一、Source Insight函数跳转怎么设置

Source Insight的函数跳转并不是只靠修改一个快捷键就能完成的，需要先把项目文件建立完整，再让软件正确地解析函数、变量、宏以及头文件之间的关系；如果项目还没有同步完成，跳转的时候就容易找不到函数，或者只能跳到声明的位置。

1、先建立完整的项目范围

项目创建之后，需要把源文件、头文件以及相关的目录都添加到工程当中；如果只添加了.c文件却没有添加.h文件，或者只添加了当前模块而没有包含公共的头文件，符号的识别就会受到影响。对于规模较大的工程，还要注意第三方库、平台层和驱动层是不是需要被纳入检索的范围，否则函数调用链就可能会断开。

2、设置函数跳转的方式

在【Options】里面检查快捷键和鼠标跳转的设置，确认跳转到定义的命令没有被别的功能覆盖掉。

Source Insight常见的跳转方式，是把光标放在函数名的上面，再通过快捷键或者按住Ctrl键并点击鼠标，进入定义所在的位置，官方的帮助文档里面也提到，Jump To Definition会根据当前被选中的符号，跳转到它的定义位置。

3、更新项目的符号库

如果刚刚新增了文件、切换了分支或者修改了头文件，跳转的结果不准确是很正常的；这个时候就需要重新同步项目，让Source Insight重新去解析符号，否则软件就还在使用旧的索引，函数的定义位置已经发生了变化，跳转却仍然指向旧的文件或者声明的位置。

二、Source Insight函数跳转到声明不进定义怎么办

跳转到了声明却不能进入定义，这种情况通常说明软件找到了函数的声明，却没有找到，或者没有优先识别出函数的实现；比较常见的原因，包括源文件没有被加入项目、函数重名、宏定义影响了解析，还有条件编译的路径不够完整。

1、检查源文件是否被加入了项目

如果只有头文件在项目里面，Source Insight自然就只能跳转到声明的位置；比如函数是在某个.c文件或者.cpp文件里面实现的，但是这个文件没有被添加到工程里面，或者它的路径被排除掉了，跳转的时候就无法进入定义。碰到这种情形，先不要怀疑快捷键的设置，而应该去检查项目文件列表是不是完整的。

2、通过项目符号去反查函数

打开【Browse Project Symbols】这个窗口，把函数名输入进去，看一看列表里面是不是同时存在声明和定义。

这个窗口可以把当前项目里面的符号都列出来，并且支持查看和跳转到符号的定义。如果列表里面只有头文件的路径，那就说明实现的文件大概率还没有被解析；如果有多个同名的函数，就需要结合文件的路径和参数，去判断应该进入哪一个。

3、检查条件编译和宏定义

不少嵌入式或者跨平台的代码，会使用宏来控制不同的实现；当前的宏要是没有被正确配置，Source Insight就有可能把真正的实现路径当成无效的代码，或者只识别到声明，比如同一个函数在不同的平台文件里面各有一份实现，宏的条件不同，跳转出来的结果就可能和当前工程的实际不符。

三、Source Insight函数跳转怎么排查更稳定

函数跳转的问题，不能只盯着单独的一个函数去看；项目文件、符号库、宏的配置和分支的版本，这些都会影响到最终的结果。比较稳当的做法，是先让符号系统正常运行起来，然后再回头去处理那些具体的、跳转异常的情况。

1、重新同步项目

在切换了代码分支、批量替换了文件，或者从Git上面更新了代码以后，最好都重新同步一下项目符号；旧的索引最容易把跳转弄得混乱，表现出来的样子就是跳到了旧的文件里面、跳到了声明的位置、找不到函数，或者把同名的函数给跳错了。

2、统一包含路径和工程配置

如果团队里面有不止一个人在使用Source Insight，最好能够把项目目录、包含路径和宏定义的配置都统一起来；否则同一套代码，有的人能跳到定义，有的人却只能跳到声明，最后再去排查的时候，就会非常耗费时间。

3、给关键函数做人工确认

对于同名的函数、静态函数、被宏包起来的函数，还有函数指针的调用，不应该完全依赖一次跳转的结果；可以把搜索、项目符号列表、调用关系和文件路径结合起来一起确认。特别是在驱动层、协议栈和平台适配层，重名和条件编译的情况比较多，依靠人工去复核一遍，是很有必要的。

总结

Source Insight函数跳转的设置，以及函数跳转到声明却不能进入定义的处理，最关键的地方是要先保证项目文件完整、符号库同步正常、宏定义和包含路径配置正确；函数跳转只到声明的时候，要优先检查实现的文件是不是被加入了项目，然后再通过项目符号列表去确认定义有没有被识别到，后续在切换分支或者更新代码以后，及时同步项目，函数的跳转就会变得稳定很多。