Source Insight 4.0的日常使用操作（保姆级）

一、软件介绍

Source Insight 这款软件，可以用来阅读和编辑代码，但是不能用来下载和编译代码，个人感觉在window下使用还挺好用，但是如果是在Linux环境下进行代码开发的话（无论是在虚拟机还是linux系统），个人感觉使用VScode会更加好用点（勿喷）。

二、建立工程

2.1 详细文字讲解：

• 第一步：新建工程：
  • 点击菜单【Project】>【New Project】；
• 第二步：设置工程名及工程数据目录：
  • 在弹出的【New Project】对话框中设置【New project name】（项目的名称）；
  • 设置【Where do you want to store the project data file?】 （项目文件保存位置）（也就是想把Source Insight项目放在哪里？）；
  • 点击【Browse】按钮选择源码的目录；
• 第三步：指定源码目录：
  • 点击【Project Source Directory – the main location of your source files】（源码目录）右边的【…】选择源码目录，并点击【OK】；
• 第四步：添加源码：
  • 在新弹出的对话框中，点击【Add】或【Add All】（“Add”是手动选择需要添加的文件，而“Add All”是添加所有文件）（同样的“Remove File”，“Remove All”是移除单个文件或者移除所有文件），一般使用“Add All”；
  • 在弹出的提示框中勾上【Recursively add lower sub-directories】(递归添加下级的子目录)并点击【OK】（另外一个【Include top level…】已经是默认被勾上的，不用管）；
  • 勾上【Show only known file types】（已经是默认被勾上的，不用管）；
  • 添加文件完成后点击【Close】，此时界面会返回到主界面；
• 第五步：同步文件：同步文件的意思是让Source Insight去解析源码，生成数据库，这样有助于以后阅读源码。比如点击某个函数时就可以飞快地跳到它定义的地方。
  • 先点击菜单【Project】>【Synchronize Files】；
  • 在弹出的对话框中 勾上【Force all files to be re-parsed】（强制解析所有文件）；
  • 点击【Start】按钮开始同步；

2.2 详细图文讲解：

2.2.1 新建工程

2.2.2 设置工程名及工程数据目录

2.2.3 指定源码目录

2.2.4 添加源码

按钮	说明
Add	基本的文件添加操作
Add All	添加整个工程所有的源文件（然后再选择是否递归添加子目录中的源文件,见上图对话框）
Add Tree	添加指定的文件夹以及其子目录下的源代码文件
Remove Tree	和Add Tree的功能相反
File Name	可以不用填写，完成点击close

2.2.5 同步文件
将添加的代码进行同步，生成阅读代码的索引和辅助文件，方便对源代码进行阅读;点击Project–> synchronization file,

三、修改编码格式（解决中文显示出现乱码问题）

3.1 更改所有文件的编码

• 菜单栏中 【Options】 > 【Preferences】 >File标签中，最下面的“Default encod­ing” 选项；

• 选择“Chinese Simplified（GB2312）CP:936”（简体中文）这个编码即可改为GB2312；

3.2 更改单个文件编码

• 菜单栏中 【File】 > 【Reload As Encoding…】 > 【Chinese Simplified（GB2312）CP:936】 > 选择后，点击load；

四、日常常用操作

4.1 打开工程

• 点击菜单“Project -> Open Porject”
• 在列表中选中以前建立工程后，点击OK；

4.2 在工程中打开文件

• 点击"P"图标打开文件列表（Project Files），双击文件打开文件（也可以在输入框内输入文件名查找文件）；

4.3 在文件中查看函数或变量的定义

• 打开文件后，按住ctrl键的同时，用鼠标点击函数、变量，就会跳到定义它的位置

4.4 查找函数或变量的引用

• 双击选中函数，右键点击弹出对话框选择“Lookup Reference”（或者双击函数后，使用快捷键"ctrl+/"来查找引用）；

• 查找选项设置：

  • 选项	说明
    Case Sensitive	大小写敏感
    Whole Words Only	整词查找
    Skip Inactive Code	忽略未使用代码
    Skip Comments	忽略注释

• 点击“Search”

• 搜索出结果后，点击左边红色箭头会打开文件，再点击红色箭头，会返回搜索结果界面；

五、常用快捷键介绍

快捷键	说明
Alt + ,	后退
Alt + .	前进
F8	高亮选中的字符
Ctrl+F	查找
F3或Shift+F3	往前查找
F4或Shift+F4	往后查找

六、面板

打开Source Insight相关窗口

（1）打开Symbol Window。

View->Symbol Window。快捷键：Alt+F8。

（2）打开Context Window。

View->Panels->Context Window。

（3）打开Relation Window。

View->Panels->Relation Window

6.1 文件成员列表面板

6.2 上下文面板

6.3 引用关系面板

6.4 文件浏览面板

6.5 窗口字体大小与样式设置步骤

Preferences->Colors&Fonts->Set Panel Fonts and Colors。

这里设置只对上面窗口1：符号窗口（Symbol Window）和窗口4：项目文件夹浏览窗口（Project Folder Browser）有效，另外两个窗口无效。

窗口2：上下文窗口（Context Window）字体大小设置如下：

在面板内右击->Context Window Options->scaling。

窗口3：引用关系窗口（Relation Window）字体大小设置如下：

窗口内右击->Relation Window Options->Font。