为SourceInsight添加“编译”

在Help手册中索引 Source Links 得到以下小节：

Creating Source Links

Parse Source Links

Using Links With Compiler Errors

Using Links With Search Output

译文如下

Creating Source Links

可使用 Parse Source Links 命令在当前(log)文件中创建 source links . 此命令需要你指定一个 search pattern 从(log)文件中解析出“文件名”和“行号”. 每搜索到一个与pattern 的匹配，就在(log)文件中插入一个source link.

Parse Source Links 命令在分析编译器输出的错误信息时很有用。你只需要打开 log文件，执行Parse Source Links 命令就会为每个错误信息生成到源码中相应位置的source link.

Parse Source Links

Parse Source Links 命令使用指定的 pattern 搜索当前文件。pattern的表达式中必须包含2个组，分别对应“文件名”和“行号”，如果你选择 File, then Line 则第一组表示“文件”。

Pattern

pattern 即用于搜索“文件名”和“行号”的正则表达式。编译器输出的log中就包含“文件名”和“行号”信息，当然还有错误描述。你只需要打开 log文件，执行Parse Source Links 命令就会为每个错误信息生成到源码中相应位置的source link. 

Using Links With Compiler Errors

如果从Source Insight通过custom command 启动编译，你可以捕获编译输出并分析错误信息，然后使用Go To First Link /Go To Next Link 查看每个错误及对应的源码位置.

当你定义自定义命令“Compile File” 时勾选了“Parse Source Links”，Source Insight 会搜索编译输出并为每个错误信息添加source link.  即“link sources” 是编译错误描述，而“link target”是对应的“文件名”和“行号”.

To view source lines with errors

让si定位编译错误:

1. 运行自定义命令“Compile File”。关于如何自定义命令见 “Creating a Compile and Build command”.

2. 假设有编译错误，当编译完成后这些错误信息会显示在 command output window. SI 会自动添加 source links，执行 Go To First Link 命令即可定位到第一条错误。

3. 执行 Go To Next Link 则定位到下一条错误。

4. 继续执行 Go To Next Link 直到最后一条错误被定位时si会 beep 一声音，并在状态栏显示“No links.”.

Using Links With Search Output

关于Source Links应用，一般人最常用的是 Search Files 命令，它会把搜索结果输出到 Search Results window. 其中每行是一个包含source link的匹配行，“link target” 是这个匹配所在的“文件名”和“行号”.

To view each place where a pattern was found:

搜索到结果后，可用 Go To First Link 导航到第一个匹配，使用 Go To Next Link 导航到下一个匹配，使用 Go To Previous Link 导航到上一个匹配。

 

---

Creating a Compile and Build command

你可以通过自定义命令从 Source Insight 启动编译，然后捕获并分析编译输出信息，并使用 Go To First Link and Go To Next Link 定位错误。

To create a simple Compile command

添加一个简单的编译命令:

1. 执行 Custom Command 命令，点击 Add.

2. 在 Name 框中输入“Compile File”.

3. 在 Run 框中输入“cl %f”. 这会把当前文件作为参数调用编译器.  当然，你也可以在此调用 make 程序，或者一个批处理. 如“cmd /c mybatch.bat”将调用批处理 mybatch.bat。

4. 勾选 Parse Source Links 。si提供一个默认的 parse pattern 用于解析编译输出信息。若有需要，修改之以便能从你的编译错误信息中解析出“文件名”和“行号”。

5. 勾选 Save Files First ，表示执行编译前自动保存文件。

6. 点击 Run 运行这个自定义命令。当然，你也可以点击 Menu or Keys 按钮为这个自定义命令指定菜单或快捷键。

勾选  Parse Source Links 表示 Source Insight 将捕获编译输出并分析错误信息，为它们添加 Source Link。这样你可以使用Go To First Link /Go To Next Link 查看每个错误及对应的源码位置.

我的编译器：

“cl %f”是针对微软的编译命令。我使用的是gcc，我的

Run框中填写的内容如下

F:\QtSDK\mingw\bin\gcc.exe %f

Dir框中填写的内容如下

F:\QtSDK\mingw\bin\

效果：