一直用NPP，很长时间了，最近才学习它的各种插件，这篇文章是根据NppExec的用户指南写的。很多地方是翻译的，但不全是翻译，同时也有些东西没有翻译。
一、何为NppExec
简单的说，这个插件可以让用户在NPP中直接运行一些命令和程序，而不用启动这些命令和程序对应的实际工具或编译器。
1. NppExec是...
- NppExec是介于Notepad++和外部工具/编译器之间的一个中间件。它允许用户在NPP中直接运行这些工具/编译器。
- NppExec是一个控制台(Console)窗口，它能展示运行过程的输出结果，并将控制台窗口的输入重新定向(redirect)到运行过程中（有一些限制）。
- NppExec是其内部命令的一个解释器。通过"Execute..."(执行)对话框，它能逐条执行多条NppExec命令（也称为NppExec脚本），也能从控制台窗口直接执行单条命令。
2. NppExec不是...
- NppExec并不是一个控制台模拟器(console emulator)。NppExec的Console不是一个“真正”的控制台窗口，它没有提供控制台屏幕缓冲区(console screen buffer)。我的理解是NppExec的Console窗口中只是输出代码在真正的控制台中运行的结果。
- NppExec并不是一个命令解释器。虽然它能执行NppExec的命令或脚本，但它不能理解诸如'copy'之类的命令。
- NppExec并不是一个编译器。它能执行外部编译器的代码，但它本身不是编译器，执行这些代码不是它自己的功能。
二、安装
在“插件'菜单下打开插件管理器(Plugin Manager)，在可以插件(Available)中找到NppExec，选择后点击下方的"Install"就可以了。安装完成后NPP会提示重启，重启后在插件菜单下就能看到NppExec。
三、基本用法
1. 获取帮助
Plugins -> NppExec -> Help/Manual ：打开用户指南。
Plugins -> NppExec -> Help/Docs... ：打开NppExec.txt和NppExec_TechInfo.txt文件，前者包括NppExec的所有命令、环境变量的语法和说明，后者包括NppExec的一些高级”隐藏“设置。
help：在Console中输入help可以查看以下内容
- 控制台快捷键
- 控制台命令
- 通用命令(General commands)和环境变量
help <command> ：help后加上命令的名字(中间用空格隔开)可以直接查看该命令的帮助文档。
2. 简介
NppExec的主要原理与NPP中的“运行”命令(F5)相同：执行给定的命令。通常就是以给定的参数执行一些程序或工具，参数能够以NPP中环境变量的形式来传递。比如，在IE中启动当前文件或者用某个编译器编译当前文件。NppExec提供了额外功能：
- 它有一个控制台窗口显示控制台程序的输出
- 它允许用户逐条执行多条命令
- 它提供了NPP的所有环境变量，也加入了它自己的若干变量
- 它有一些额外命令，只有想不到，没有做不到 :)
- niubility :)
NppExec中执行命令的四种方式： （四种方式）
- 使用NppExec的控制台窗口：输入命令，按Enter执行
- 使用NppExec的“Execute...”对话框：可以输入多条命令，保存为NppExec脚本，执行时逐条执行
- 使用NppExec的"npp_exec <script>"命令：执行脚本
- 使用NppExec的"npp_exec <file>"命令：执行文本文件保存的脚本
BTW，NppExec的菜单项使用第三种方法执行脚本。
有关内部过程和外部过程在下面“小试牛刀”这一节中。
3. 小试牛刀
3.1 以内部过程的方式执行程序
在控制台窗口或Execute窗口直接输入程序的名字（必要时添加路径）就可以按内部过程的方式运行程序，输入时也可以带参数。
比如：输入cmd可以运行windows的命令提示窗口（cmd.exe程序），由于cmd本身是控制台程序，因此它会在NppExec的Console窗口中运行，也就可以接着在Console窗口中直接输入cmd的命令来运行，用exit命令退出cmd。 又，输入calc则运行windows自带的计算器。由于计算器不是控制台程序，因此它独立运行。
可以看到，以内部过程运行程序，不管是控制台程序还是非控制台程序，开始都打印Process started >>>，结束后打印<<< Process finished.(Exit code 0)。括号中的Exit code值可能会改变，表示不同的退出状态。这是NppExec在等待内部过程执行完毕。
下面是cmd中查看系统时间的一个例子(控制台中)：
1 ================ READY ================
2 cmd
3 cmd
4 Process started >>>
5 Microsoft Windows [版本 6.3.9600]
6 (c) 2013 Microsoft Corporation。保留所有权利。
7
8 C:UsersactonDesktop>time /t
9 time /t
10 00:13
11
12 C:UsersactonDesktop>exit
13 exit
14 <<< Process finished. (Exit code 0)
15 ================ READY ================
也可以在运行程序时带参数，查看时间可以写成：
1 ================ READY ================
2 cmd /c time /t
3 cmd /c time /t
4 Process started >>>
5 00:16
6 <<< Process finished. (Exit code 0)
7 ================ READY ================
.cmd和.bat文件也能这样执行，但不能省略扩展名。
3.2 以外部过程的方式执行程序
使用npp_run <command>，如下，会打开cmd窗口，Console中不会输出Process started和Process finished，NppExec不会等待外部过程的执行。
1 ================ READY ================
2 npp_run cmd
3 NPP_RUN: cmd
4 ================ READY ================
小结：NppExec能理解的只是它的内部命令和环境变量。
- 当输入其他命令时，比如"copy", "cmd"或"calc"，NppExec尝试将其作为子过程来执行，i.e. 它执行CreateProcess(...)直到子过程结束。
- 当输入类似"npp_run cmd"或"npp_run calc"时，NppExec尝试以外部过程的方式执行指定的命令，i.e. 它执行ShellExecute(...)，且不关心这个过程。
4. NppExec的子菜单
- Execute...：打开 "Execute..."对话框（默认热键F6）
- Direct Execute Previous：执行之前的脚本（默认Ctrl+F6）
- Show Console dialog：打开或隐藏Console窗口（默认Ctrl+~）
- Toggle Console dialog：激活或取消激活Console窗口（依赖Console的"hide toggled Console"选项，但是找不到这个选项在哪里）
- Console Commands History：Console命令历史是否可用（可用时上下键自动输入历史命令）
- Console Output...：打开Console Output/Input encoding对话框，选择输入输出的编码
- No internal messages：不显示命令确认等内部消息。比较如下，前面没有内部消息，后面有内部消息：
1 ================ READY ================
2 cmd
3 Microsoft Windows [版本 6.3.9600]
4 (c) 2013 Microsoft Corporation。保留所有权利。
5
6 C:UsersactonDesktop>exit
7 exit
8 ================ READY ================
9 cmd
10 cmd
11 Process started >>>
12 Microsoft Windows [版本 6.3.9600]
13 (c) 2013 Microsoft Corporation。保留所有权利。
14
15 C:UsersactonDesktop>exit
16 exit
17 <<< Process finished. (Exit code 0)
18 ================ READY ================
- Save all files on execute：执行NppExec脚本前始终保存修改过的文件
- Follow $(CURRENT_DIRECTORY)：始终以当前目录执行脚本（当前目录用cd命令查看或更改，请help）
- Disable command aliases：命令别名不可用(用NPE_CMDALIAS查看别名)
- Console Output Filters...：显示NppExec Console Filters对话框(Shift + F6)
- Advanced Options...：高级选项（可以添加菜单项，用于执行脚本）
- Change Console Font...：字体
- Help/Manual Help/Docs...
- Help/About
5. NppExec Console
可以用菜单、快捷键和工具栏图标打开，倒数第二个图标就是（反正我的是哈...）。
高级设置中的ToolbarBtn可以选择在工具栏显示Console/Execute/Execute Previous中的一个或不显示任何图标。
主要作用：
- 执行命令（Enter键）
- 当执行内部子过程，且为控制台程序时，显示运行结果（比如Python或cmd的运行结果）
- 显示内部消息
- help
- ...(有一个没看懂)
6. "Execute..."
打开方式：F6、菜单或工具栏（需要设置）。
用于执行脚本。
可以在<temporary script>中执行，也可以点击Save保存脚本。保存后可以在高级选项中设置为NppExec的菜单项，分配热键。 比如以下脚本：
1 // save current file
2 NPP_SAVE
3 // copy current file to C:Backup
4 cmd /c copy "$(FULL_CURRENT_PATH)" "C:Backup$(FILE_NAME)" /Y
首先保存当前文件，然后用cmd中的copy命令复制到C:Backup下，其中//开始的是注释。
7. NppExec脚本
NppExec脚本是一个命令集。
- 可以是NppExec的内部命令，比如"cls", "npp_save", "npe_debuglog"等
- 也可以是可执行的一些外部程序或命令，比如"cmd", "calc", "C: ools cc cc.exe" 。
- 每条命令都可以带参数。比如以下几条命令：
1 INPUTBOX "Input something:" : something
2 NPP_EXEC "script name" "param 1" "param 2"
3 cmd /c copy /?
4 "C: ools cc cc.exe" "$(FULL_CURRENT_PATH)" -run
注意：
- 一条命令书写在一行中。
- 注释以//开始。
- 脚本可以保存为txt文件，用npp_exec执行。
- 脚本存储在插件配置目录下，该目录存储在环境变量$(PLUGINS_CONFIG_DIR)中。
- 保存的脚本在npes_saved.txt中，从其中可以查看脚本保存的格式。临时脚本在npes_temp.txt中。
重点是执行脚本的四种方式、两类过程（内部和外部）和脚本基础知识，下次介绍环境变量。