如何在Notepad++中安装Poor Mans T-SQL Formatter插件

给SQL代码做格式化，这事儿说大不大，说小不小。手动调整缩进和换行，费时费力还容易出错；用对了工具，却能一键让杂乱无章的脚本变得清晰可读。对于常用Notepad++写SQL的朋友来说，Poor Man's T-Sql Formatter插件是个不错的选择。不过，它的安装过程可不像点个“下一步”那么简单，里头有几个常见的“坑”需要留意。

Notepad++插件管理器安装失败怎么办

想通过Notepad++自带的插件管理器直接安装？大概率会碰壁。这真不是你的操作问题，而是因为官方的插件仓库已经很久没更新了，Plugin Manager的列表里要么找不到这个插件，要么显示的是旧版本，网络连接也时常不稳定。

最稳妥的办法，是绕开管理器，手动安装：

• 直接访问插件的官方下载页面：http://architectshack.com/PoorMansTSqlFormatter.ashx（注意后缀是.ashx），找到最新的SqlFormatterNppPlugin.x.x.x.zip文件并下载。
• 解压下载的压缩包，你会看到PoorMansTSqlFormatterNppPlugin.dll这个动态链接库文件，以及一个同名的文件夹。
• 将.dll文件和整个同名文件夹，一并复制到Notepad++的plugins安装目录下（通常路径类似C:\Program Files\Notepad++\plugins）。
• 完成复制后，完全关闭并重新启动Notepad++。如果一切顺利，你会在菜单栏的Plugins下拉菜单中看到Poor Man's T-Sql Formatter的选项。

为什么装完没反应或菜单不出现

文件明明复制过去了，重启后菜单却“神隐”了？这通常是架构不匹配惹的祸。Notepad++有32位（x86）和64位（x64）两个版本，而这款插件目前只提供了32位版本的.dll文件。如果你安装的是2021年后常见的64位默认版本，插件就会静默加载失败。

怎么确认呢？打开Notepad++，点击Help → About Notepad++，在弹出窗口的右下角就能看到版本信息。解决办法其实就两条路：

• 卸载当前的64位版本，去官网重新下载明确标注为32-bit x86的安装包。
• 如果坚持使用64位版本，那就只能退而求其次，使用插件包中附带的命令行工具PoorMansTSqlFormatterCmdLine.exe，再配合Notepad++的“运行”功能来间接调用格式化。

安装后怎么快速格式化SQL并设置快捷键

插件成功安装并显示，并不意味着打开SQL文件就能自动美化。它需要你手动触发格式化动作。默认情况下没有快捷键，每次都去菜单里点选，效率实在太低。

给自己配置一个顺手的快捷键，几步就能搞定：

• 点击菜单栏的Settings → Shortcut Mapper…。
• 在弹出的对话框中，切换到Plugin commands标签页。
• 在长长的列表里，找到名为Format T-SQL Code的项（注意名称要认准，别和其他的格式化命令搞混了）。
• 双击该项最右侧的空白列，按下你习惯的快捷键组合（比如Ctrl+Alt+F），然后点击OK保存。

设置完成后，无论是选中一段SQL文本，还是仅仅将光标放在文件内，按下你设置的快捷键，插件就会立刻工作——关键字自动转大写、缩进层层对齐、子句合理换行，代码的整洁度瞬间提升。

格式化效果不符合预期？检查选项配置

有时候，格式化后的代码风格可能和你的团队规范或个人习惯不太一样。比如，你希望所有关键字都变成大写，或者希望用Tab而不是空格来缩进。别担心，插件的默认配置是可以调整的，只是入口藏得有点深：

• 点击菜单Plugins → Poor Man's T-Sql Formatter → Options。
• 这里有几个关键选项值得关注：勾选Uppercase keywords（这会让SELECT、FROM等关键字大写）；根据喜好决定Indent with spaces（如果用Tab更符合你的项目约定，就取消勾选）；调整Max line length（设置一个值，比如120，可以避免产生过长的代码行）。
• 修改选项后无需重启软件，下次执行格式化命令时，新设置就会立即生效。

有个小提示：选项窗口里的“Preview”按钮，只能预览当前光标所在行或选中片段的效果，无法反映整个文件的格式化面貌。要验证配置是否完全符合心意，最好还是实际执行一次Format T-SQL Code来看看全文效果。