source insight 笔记

一、建立工程、界面介绍

1. 打开Source Insight，选择Project 菜单->New Project；
2. 在出现的对话框中选择并选择存放工程文件的文件夹，输入工程名（比如McuSystem），点击“保存”；
3. 又出现一个对话框，在 Configuration 部分可以选择这个工程使用全局配置文件还是自己单独的配置文件，这个无所谓，（不过最好选择单独的配置文件），再点击“OK”；
4. 再次出现一个对话框，这是选择文件添加到 Project 中，通过左边的树状图找到你想添加的文件，点击Add 就可以了。你可以将不通路径下的文件添加到同一个工程中，而不用拷贝源文件。选择完后点击Close；
   　　这样工程就建立好了，文件列表就出现在Project Window 中（如果Project Window 被关闭了，可以选中View菜单->Project Window）。点击Project Window 中任意一个文件，文件的内容出现在中央的编辑区了。

注意：
　　如果某个函数或变量是小黑字显示，那么这个函数或者变量在这个工程内就还
没有定义（如下图）。这便于检查程序中未定义的函数、变量。当然啦，如果是诸如printf这样的库函数，你可以不用管，编译器自己会找到这个函数。

有时候可能会出现明明定义了的函数或者变量，却仍然是小黑字，这时你可以点击
Project菜单->Synchronize Files，让文件重新同步一下。

工具栏上有两个蓝黑色的向前、向后图标，它可以让编辑区转到你前一次、后一次编辑过的地方，这在源文件很多的时候特别有用。比如说你先后修改了3 个文件中的3个函数，现在又想回过头来再改改第一个函数，只要点击“向前”图标三次就可以回到第一个函数那里。

source insight 查询功能

查找定义

在编辑区内，选中任意一个变量、函数、宏等，点击右键->Jump Definition。

　如果只有一个定义，编辑区就会自动转到这个变量、函数、宏定义处；
　如果有多个定义（比如 McuSystem 中的msg_queue_out（）函数，根据宏定义不同，对应不同函数），将会出现一个定义列表，选择不同表项，编辑区就会转到相应的定义处。

或者，在编辑区内，选中这个变量、函数、宏等，过了1、2秒钟，Context Window会自动显示这个变量、函数、宏定义、或者多个定义列表。

查找：

1. 在编辑区内，选中要查找的变量、函数、宏等，点击右键->Lookup Reference；
2. 出现Lookup Reference 对话框，（关于Option 选项，我们后面再说），点击Search；
3. 接下来的对话框是选择查询结果的存放、显示方式，一般选择 Replace（你可以试试其它选项的效果）；（如果将查找结果列表窗口关闭，这个对话框就不出现）
4. 接下来就出现了查询结果列表窗口。
5. 点击任意一条结果前的红色图标，编辑区就转到了程序中相应的部分；在编辑
   区点击语句开头的红色图标就又回到查询结果列表；或者点击任务栏中红色向左、向右图标，就可以在不同查询结果之间转换。

现在我们在说说前面提到的 Lookup Reference 对话框的关于Option 选项。

• Case Sensitive：查找时区分大小写；
• Skip Inactive Code：诸如#if 0 .... #endif内的代码，因为是Inactive的，所以不在查找之列；
• Skip Comments：注释内的代码不在查找之列

• Search Only Comments：只查找注释内的代码

  　　当Search Method 选中Simple String 时，还可以选中或者取消Whole Words Only 选项。当取消Whole Words Only 时，就不再按照整字查询，举个例子，当你查询“int”时，“interrupt”也会被查到。

查找调用

在编辑区内，选中函数名，点击右键->Jump to Caller；

如果这个变量、函数、宏等在工程中只被调用了一次，编辑区会直接转到该处；

如果被调用了多次，就会出现查询结果列表对话框，选择不同表项，编辑区就会转到相应的调用处。

这里说的 Jump to Caller 和前面说的Lookup Reference 很相似，Jump to Caller 的查询条件更加严格，定义、声明、注释等都不在它的查询之列。

`Jump to Caller` 有这种情况存在：
如果函数A 中多次调用函数B，使用`Jump to Caller` 时，A 中的B 函数只会被列出一次。
所以我个人更加喜欢用`Lookup Reference`。

小细节

凡是修改了、还没有保存的语句，前面都用黄色标注。

修改了保存了的语句，前面用绿色标注。

二、常用使用技巧

1. 按住"ctrl", 再用鼠标指向某个变量(或函数)，点击一下，就能进入这个变量（或
   函数）的定义。
2. 快捷键 "Alt + F12"，可以让显示界面中的每个字符宽度一致。
3. "shift+F8" 标亮所有文本中光标所在位置的单词。
4. 跳到某一行：F5 或者"ctrl + g"。
5. "Ctrl + o"跳转至Project Window的查找入口，"回车"大开相应文件并关闭查找窗口；如果找不到直接使用ESC键也可关闭该查找窗口。

快捷键

窗口操作

三、常用问题解决

1. 文件过滤器
   
2. 颜色选择
   
3. 解决字符大小不一
   
4. 解决缩进问题
   
5. 解决汉字注释操作半删半移问题
   
6. 恢复Ctrl + a的全选功能
   

本文内容部分摘自：
1. http://wenku.baidu.com/link?url=gQZpIQQKc6nKY9c7LG4VUspNwTTmlYPp5Onw3Y-JOLaRGMjdwmRXGqBHIenB84eiASr74TxYih3X_oFoVxJmboVzWER1Yt7xWnTiUWR-Co_