source insight 配置

当然， Source Insight 还提供了一些其他常见的便利。比如 : 右键菜单几乎包含了程序的所有功能，可以在编辑窗口为程序加上行号，还可以统计整个工程的程序行数 , 当然还有功能强大却用不上的自动完成功能。

配置成简单好用的c/java代码编辑器

1、缩进与tab

（ 1 ） Options 菜单 à Preferences à Typing 卡，勾掉下面两项∶

Typing tab indents line ， regardless of selection ，空行按 tab 无法前进

Typing tab replaces current selection ，选定部分内容、再按 tab 时会清除所选

（ 2 ） Options 菜单 à Document Options （针对不同文件类型，分别进行设置） à 下拉左上文件类型框、选择合适类型（ c 源文件） à Editing Options 框中， tab width=2 à Editing Options 框中，勾选 Expand tabs （这样，按 tab 键、等价于输入 2 个空格）

（ 3 ） Options 菜单 à Document Options à 选择合适的文件类型 à 点击右边中间的 Auto Indent 钮 à 在弹出的框中，左边一定要点 Smart ，右边有两个复选框 Indent Open Brace 和 Indent Close Brace ，具体效果可以看 SIS 的 HELP 。按照部门里的编程风格要求，最方便的就是把两个复选框都取消掉，然后点 OK 。

勾选 Auto Indent 之 SMART 的效果∶在 C 程序里 , 如果遇到行末没有分号的语句 , 如 IF, WHILE, SWITCH 等 , 写到该行末按回车，则新行自动相对上一行缩进两列。

勾掉 Indent Open Brace 和 Indent Close Brace 的效果∶继上一段，在相对缩进行里 , 如果输入 "}", 则自动和上一行列对齐（好像勾不勾都会有这个功能）；而输入 "{" 时，不会与下面的行对齐（这是勾上 Indent Open Brace 时的效果）。

2、向项目中添加文件时，只添加特定类型的文件（文件类型过滤器）

有个同事比较生猛，得整汇编代码，但在 SIS 里建立 PROJECT 并 ADD TREE 的时候，根据默认设置并不会把该 TREE 里面所有汇编文件都包含进来，只加了 .inc 和 .asm 后缀的， .s 后缀的没有。而且用 SIS 打开 .s 的文件，一片黑白没有色彩，感觉回到 DOS 的 EDIT 时代了…… 解决方法是在 Options->Document Options 里面，点左上的 Document Type 下拉菜单，选择 x86 Asm Source File ，然后在右边的 File filter 里 *.asm ；*.inc ； 的后面加上 *.s ；接着 CLOSE 就可以了。上面两个问题解决了，但注意加入 *.s 后还需要重新 ADD TREE 一遍才能把这些汇编加到 PROJECT 里面。

3、去掉功能强大但是无用的自动完成功能

Options 菜单 à Preferences à Typing 卡 à Auto Completion 框，勾掉 Use automatic symbol completion window （这里是 SIS 的全局设置）

Options 菜单 à Document Options à Editing Options 框中，勾掉 Allow auto-complete （局部设置）

上面两项必须全部勾选，才能启用 Auto Completion 功能

4、恢复小键盘的“+，-，*，/”功能

Options 菜单 à Key assignments ，通过关键词 Scroll 找到 Scroll Half Page Up ，取消小键盘 / ；通过关键词 Scroll 找到 Scroll Half Page Down 取消小键盘 * ；通过关键词 Function 找到 Function Up ，取消小键盘 - ，通过关键词 Function 找到 Function down ，取消小键盘 + 。

5、恢复ctrl+a的全选功能

通过关键词 save 找到 save all ，更改为 ctrl+shift+a ，通过关键词 select 找到 select all ， 更改为 ctrl +a

6、解决字符等宽对齐问题。

SIS 默认字体是 VERDANA ，很漂亮。这网页上应该也是用的 VERDANA 字体。但由于美观的缘故， VERDANA 字体是不等宽的。比如下面两行

llllllllll

MMMMMMMMMM

同样 10 个字符，长度差多了 . 用 VERDANA 来看程序，有些本应该对齐的就歪了。解放方法是使用等宽的字体，但肯定比较丑。可以用 DOS 字体，也就是记事本里的默认字体 sysfixed 很丑，要有心理准备。比较推荐的是用 Courier New 。

SourceInsight提供的功能

1、解析日志信息时非常有用的Source Link

总地说来， SourceLink 根据特定的搜索模式，把当前文件中满足模式的行、链接到由该行指定的其他源文件中。

所谓特定的搜索模式，共有两种“ File, then line ”和“ Line, then file ”，其中前后两部分依靠正则表达式的组的概念来予以分割。如果当前文件具有匹配行，比如“ Error d:tcsrcq5.c 18: Lvalue required in function jsSort ”，那么 SourceInsight 在该行创建 SourceLink 、把该行链接到由该行指定的文件中（即 d:tcsrcq5.c ，第 18 行）。

1.1 创建SourceLink

运行 Search 菜单的 Parse Source Links… 命令，在弹出的框中、选择搜索模式、并填入相应的正则表达式串，点 OK ， SIS 就会解析当前文件，如果有匹配，就创建 SourceLink 。

1.2 在解析日志信息时，使用SourceLink

可以打开日志信息，运行 Parse Source Links 命令，日志中能够匹配模式的每一行（通常是含有错误信息的行）、就会被设置上一个 SourceLink

1.3在解析自定义命令输出时，使用SourceLink

首先勾选 Custom Command 中的“ Parse Links in Output ”，然后选择特定的搜索模式，最后填入合适的正则表达式。这样， Source Insight 把输出信息作为当前搜索用文件；并且，如果有匹配行（通常即编译错误信息行）， SIS 为 该行创建 SourceLink 、并把每一个错误信息中给定的文件（和行号）作为 link 目的地，这对于我们修改源代码错误非常有帮助。

2、替换（Replace） VS 上下文敏感的智能重命名（Context-Sensitive Smart Rename）

2.1 替换（Replace）

目前来说，普通的替换命令、快捷键为 ctrl+H ，足以已满足工作要求。

在弹出的替换窗口中，在 Search 框中勾选 Selection 来只在所选文本区域中替换（当然这时你要先选定区域然后再按 ctrl+H ）、勾选 WholeFile 来在整个当前文件内替换、两者都不勾选来从当前光标处替换至文件末尾；点右边的 Files… 按钮，可选择替换多个文件的内容。

2.2上下文敏感的智能重命名（Context-Sensitive Smart Rename）

Smart Rename 命令、快捷键是 Ctrl+’ ，是上下文敏感的全局搜索替换。它可以智能地重命名全部项目文件中的一个标示符。 SourceInsight 的搜索索引（ search index ）使得搜索过程进行地非常快。而且，使用 Smart Rename 所做的替换会被记录在 Search Results 窗口中，每一条替换记录旁有一个 SourceLink 链接到替换发生地文件。

Smart Rename 可以用来重命名标记（ symbol ）。如果勾选了 Smart Reference Matching 选项， Smart Rename 就只在正确的上下文范围内进行重命名。它可以智能地重命名全部项目文件中的一个标示符；它可以重命名函数本地变量，类或结构体成员、函数。

在弹出的 Smart Rename 窗口中有下面几项∶

Old Name 填旧名称。光标下的词会被自动加载；光标的位置非常重要，这是因为 Source Insight 会根据本地上下文背景、准确地确定你想要重命名哪一个标记。 推荐只填单个词、而不是字符串。 如果你在命名成员变量、或本地变量（）， Old Name 框中会显示完全标记名、即上层容器名 + 标记名。例如，框中的“ DocDraw.paintStruc ”代表 DocDraw 是函数名， paintStruc 是函数的本地成员变量。 New Name 填新名称。只填标记名，不填上层容器名。 Output Search Results 如果勾选，搜索替换结果日志会被输出到 Search Results 窗口中。可以通过 Windows 菜单来切换，或 ctrl+tab 切换察看。并且每一条记录旁会有 SourceLink 链接到替换发生地文件。 Confirm Each Replacement 每次替换询问。 Skip Comments 不重名注释部分。

 

【使用心得列表】

（１）如何用 Smart Rename 重命名数组的数组名？如果只选取数组名，会报错！

（２）如果勾掉 Smart Reference Matching ，会搜索全部项目文件，并且 Old Name 框中不显示完全限定名；如果勾选 Smart Reference Matching ，无法重命名数组名，而且鼠标位置不正确时会报错。应该如何应对？

3、在SourceInsight中提供的正则表达式

3.1在SourceInsight中提供的正则表达式

正则表达式，是用来匹配复杂模式的特殊搜索用字符串。正则表达式串中，许多字符具有特殊的含义。例如，有个特殊的字符代表 “ 行首 ” 。

下面是 SourceInsight 提供的所有可用特殊字符∶

Table 4.3: Regular Expression Characters
Character	Matches
^ (at the beginning only)	beginning of line 。如^Hello，匹配Hello在句首。
.	any single character
[abc]	any single character that belongs to the set abc
[^abc]	any single character that does not belong to the set abc
*	zero or more occurrences of the preceding character
+	one or more occurrences of the preceding character
t	a tab character
s	a space character
w	white space (a tab or a space character)
$	the end of the line 。如TRUE$，匹配TRUE在句尾。
	转义字符。如果在它后面有元字符，取消其特殊含义。

 

可利用 “(” 和 “)” 、把正则表达式分割成不同的组；模式中的每个组自左向右指定为 Group #n ， n=1,2,… ；组的概念在替换时很有用。

例如∶

abc(xyz) 可匹配 abcxyz ，其中 xyz 被认为是 group#1 ，

利用 21 来替换 (abc)(xyz) ，替换结果为 xyzabc 。

3.2 正则表达式在配置tc编译器中的应用∶

正则表达式格式与源代码文件路径相对应，这里我的 tc 安装目录为 d:tc ， tc 源文件放在 d:tcsrc 下，并命名为 qn.c 或 qtn.c （其中 n=1,2,… ）。

观察 Tc 编译器某一次输出错误信息的格式∶

Error d:tcsrcq5.c 18: Lvalue required in function jsSort

则我们要匹配“ d:tcsrcq5.c 18”部分，进一步地，按照SourceInsight 捕捉输出并加以解析时的要求，要以组的形式、分别匹配“ d:tcsrcq5.c 18”中的文件部分和行号部分∶

行号 ([1-9][0-9]*)

空格行号 s([1-9][0-9]*)

文件名 (d:tcsrc[qQ][tT][1-9][0-9]*.[cC])

全部加起来为∶

(d:tcsrc[qQ][tT]*[1-9][0-9]*.[cC])s([1-9][0-9]*)

 

3.3 正则表达式在配置javac编译器中的应用∶

我的 JAVA_HOME 是 c:jdk ，我的 java 源文件放于 d:javasrc 中，并命名为 qn.java 或 qtn.java （其中 n=1,2,… ）。

观察 JDK 编译器某一次输出错误信息的格式∶

D:javasrcQ3.java:3: ';' expected

正则表达式为∶

([dD]:javasrc[qQ][tT]*[1-9][0-9]*.java):([1-9][0-9]*)

 

4、自定义命令

自定义命令与项目相关，在一个项目中定义的所有自定义命令属于该项目、只对该项目有效（包括快捷键等）。

自定义命令类似于命令行批处理文件。 SIS 允许自定义命令在后台运行；并可以捕捉自定义命令的输出、放置于文件中、或粘贴入当前光标插入点。

分别利用上面 SIS 对输出信息的处理方式，自定义命令对集成编译器相当有用，可以捕捉编译器输出并创建 SourceLink 寻错；自定义命令对于文本过滤也相当有用，可选中待过滤区块、运行 Sort 自定义命令、粘贴回选定区块、即完成文本过滤。

请按下面步骤创建自定义命令∶

Options 菜单 à Custom Command

à 点右边 Add 钮、填入新自定义命令名称，或下拉左边 Commands 、选择命令进行修改

à Run 框、填入待执行命令行，可含有特殊元字符，见后面的元字符表

à Dir 框、执行命令行时应处的目录，如不填，以源代码文件所在目录为命令执行目录

à 勾选 Output 框的 Capture Output 、输出被捕捉，如果勾选 Paste Output ，输出被粘贴

à 勾选 Control Group 框中的 Save Files First 、 SIS 会在运行命令前先检查文件是否保存

à 勾选 Control Group 框中的 Pause When Done 、 SIS 会在命令结束后暂停、方便检查

à 勾选 Source Links in Output 框中的 Parse Source Links ，?/p>