【EverEdit用户手册】外部工具

 

 

1 【EverEdit用户手册】外部工具

1.1 应用场景

  用户在编写脚本或代码时，需要频繁切换到命令行窗口进行编译或调试，来回切换不仅降低了用户效率，还会打乱用户的思路。
  如果不用切换命令行窗口，而是类似IDE直接通过菜单进行编译或调试，将会给用户带来极大的便利。
  EverEdit提供了配置外部工具的能力，配置完成后通过EverEdit的菜单调用外部可执行程序，并获取输出结果打印到EverEdit的输出窗口，用户不用来回切换编辑器和命令行窗口即可完成编译和调试工作。

1.2 使用方法

1.2.1 配置外部工具

  下文以Python文件的编辑和调试来进行举例说明：

1. 步骤1： 选择主菜单工具 -> 外部工具，弹出外部工具窗口
2. 步骤2：在外部工具窗口中单击添加按钮，如下图所示：
   

• 标题：设置新工具的标题，即在菜单中显示的文字。
• 命令：要调用的外部工具的名称或全路径文件名(建议)，单击编辑框右侧的“...”按钮会打开文件对话框，用户可以通过对话框选中可执行文件。

🕮说明：
如果仅使用名称，则需要在环境变量Path中设置工具路径。

• 参数：传递给可执行程序的参数，一般设置为当前正在编辑的文件名。
  单击参数编辑框右侧的“”按钮，可以显示EverEdit支持的内部变量，如下图所示：
  

• 初始目录：设置可执行程序的初始目录，可执行程序切换到初始目录后，该目录下的文件做参数传递给可执行程序可以省略路径。
  用户可以直接在该编辑框中输入路径，也可以使用内部变量，单击初始目录编辑框右侧的“”按钮即可显示该参数支持的内部变量。

• 动作模式：即可执行程序执行完成后的输出报文如何处理，一般选择“捕获输出(隐藏窗口)”，隐藏的作用是不显示黑色的命令行窗口，使整个可执行程序调用过程无感。

• 接受输入：该选项选中时，如果可执行程序需要接受输入，EverEdit会自动显示命令窗口并将输入焦点定位到命令窗口，用户直接输入内容即可。

1.2.2 功能按钮说明

• 添加：添加新的工具。
• 删除：删除选中的工具。
• 图标：给选定的工具设置图标。
• 添加分组：为工具添加分组，添加分组后下拉列表会显示新添加的分组，用户如果需要管理大量工具，可以尝试使用分组的方式。
• 删除分组：在分组下拉列表中选择用户添加的分组后，该按钮激活，单击删除分组后，当前选择的分组会删除。
  注：默认分组不可删除。
• 高级：对输出报文和命令执行时的行为进行定制。

1.2.3 高级设置

单击动作模式右侧的高级按钮，会弹出高级设置对话框，如下图所示：

• 使用输出定位：当用户调用外部工具时，比如：python， 在运行源文件时出错，输出窗口会打印错误报文，其中会提示文件名，行号等信息，一般在IDE中，鼠标双击输出报文，会自动跳转到源文件出错位置。
  EverEdit也提供了这种能力，即通过正则表达式对输出报文进行分析，提取出源文件名，行号，列号(可选)，用户在输出窗口双击带行号的报文时，自动跳转到源文件对应位置。
• 正则表达式：用于提取源文件名、行号、列号的正则表达式
• 文件路径：选择正则表达式中代表文件名的分组，捕获1表示第1个分组
• 行号：选择正则表达式中代表行号的分组，捕获2表示第2个分组
• 列号：如果报文中打印了列号，可以通过正则表达式的分组捕获对应的信息，该值如果不设置，则跳转到第1列。

示例：

import os

name = input("What is your name?")
print("Your input name is: %s" % (name))
println("hello error!") #这行代码有错误

输出报文：

• 保存模式：执行外部工具时，保存当前编辑的文件或保存所有打开的文件。
• 输出编码：输出报文的编码格式，如果输出窗口出现乱码时，可以尝试切换编码。

---

文档作者声明：本文档仅用于学习交流，未经作者许可，不得将本文档用于其他目的。
Copyright © 2022~2024 All rights reserved.

>