SourceInsight使用指南

Source Insight使用指南

目录

1.Source Insight 基本设置 (3)

1.1字体设置 (3)

1.2自动缩进设置 (3)

1.3其它设置 (4)

2.Source Insight中的宏 (5)

2.1使用宏 (5)

2.2指定快捷键 (6)

3.Source Insight中的自定义命令 (6)

3.1如何自定义命令 (6)

3.2指定快捷键 (7)

3.3正则表达式语法 (7)

3.4集成编译器 (8)

3.5集成版本控制工具 (10)

4.其它 (11)

4.1特殊的注释 (11)

1.Source Insight 基本设置

1.1字体设置

Option-〉Document Options 文档设置。

Screen Fonts 设置显示字体。推荐使用等宽字体，如“Courier”，这样在代码对齐时容易处理，但中文字体显示有锯齿。使用“宋体”字时，代码可能存在对齐问题。

1.2自动缩进设置

Option-〉Document Options-〉Auto Indent 自动缩进设置。详细缩进样式请参考Source Insight 帮助的Command Reference-> Document Options-〉Auto Indenting。

Auto Indent Type 选择 Smart

Smart Indent Options 两个复选框都不要选择

缩进后样式如：

if()

{

}

1.3其它设置

Editing Options 编辑器设置

Show line numbers 显示行号

Show right margin 显示右边界线（边界线显示在Margin width 处）

Tab width TAB键宽度，设置为 4

Margin width 页空白宽度，页面右边界线的位置，设置为80。选择后在编辑窗口右

侧设置的宽度处出现分割线

Show page breaks 显示页面分割线，选择后在编辑窗口出现打印页分割线

●如果编辑窗口中的中文字符中间分割过大或者出现对齐问题时，请尝试如下设置：

Options-> Preferences-> Display-> Spacing

选择Layout tabstops using monospace calculations 和Layout spaces using monospace calculations

●定制Open命令

Options-> Preferences-> Files-〉Custom “Open” Command

2.Source Insight中的宏

2.1使用宏

首先关闭当前使用中的Source Insight，然后复制macro\utils.em 到我的文档\Source

Insight\Projects\Base，覆盖原有的文件。最后重新打开Source Insight，在Project-〉Open Project中找到 Base工程打开并做同步（Synchronize Files）。

宏中使用的代码修改者的名字是Source Insight安装时注册用的用户名。如果不合适，请重新安装Source Insight并指定正确的用户名。

2.2指定快捷键

Option-〉Key Assignments

在Command栏中找到需要的宏，点击 Assign New Key来指定快捷键。（在这里你可以为Source Insight中的所有命令指定快捷键）。

3.Source Insight中的自定义命令

3.1如何自定义命令

Source Insight的自定义命令执行类似于批处理的执行，并且Source Insight可以捕捉命令执行的输出。详细内容请参考Source Insight帮助的Command Reference-> Custom Commands部分。

Option-〉Custom Commands 自定义命令

Add 新增一条命令

Command 命令名称

Run 需要执行的命令，可以是单条命令，也可以是一个批处理程序

Iconic Window 命令执行时窗口最小化

Caputre Output 捕捉命令输出

Save Files First 执行命令前先保存编辑的文件

Pause When Done 命令执行完成后暂停

Parse Links in Output 解析输出中的连接信息

Pattern Contains 文件名和行号的顺序

Pattern 解析规则

3.2指定快捷键

参考2.2节。

3.3正则表达式语法

正则表达式一般用在文本查找、替换和命令执行结果解析时。例如从捕获的编译器输出中

解析出错误的位置信息等。

Source Insight正则表达式最重要的概念就是群组（Groups）。群组用来表示一个特定的字符串对象。一个群组以“\(”开始，以“\)”结束。在一个表达式中可以有多个群组，群组从左至右从1开始依次编号。

详细的正则表达式用法请参考Source Insight帮助的Source Insight Concepts-> Regular Expressions部分。

例1 从编译器的输出中解析错误的位置信息时，必须有两个群组，一个表示文件的位置，一个表示行号。

^\([A-Za-z:]*[\\a-zA-Z0-9_./]+\):\([0-9]+\)

\([A-Za-z:]*[\\a-zA-Z0-9_./]+\) 为一个群组，表示文件位置信息

\([0-9]+\) 为一个群组，表示行号

例2 如下替换方法将把文件中所有的xyzabc 替换为abcxyz。注意选择Use Regular Expressions

3.4集成编译器

在Source Insight的自定义命令中已经集成有 Build Project、Compile File和Clear Build。这三个默认的命令在工具栏上有相应的快捷方式。

对于Run一栏中所用的参数（%j %o等），请参考Command Reference-> Custom Commands-> Command Line Substitutions。

Pattern 栏中为：“^\([A-Za-z:]*[\\a-zA-Z0-9_./\-\ ]+\):\([0-9]+\)”。

只解析错误（忽略警告信息）时，Pattern栏中填入：

“^\([A-Za-z:]*[\\a-zA-Z0-9_./\-\ ]+\):\([0-9]+\):[0-9]*: error:”。

关于批处理程序中使用的命令请参考 Microsft Windows 的帮助。

以Workbench3.0为例，定制Build Project 命令

打开Custom Command窗口，做如下设置。