SQLinForm 插件安装失败主因是Notepad++架构（x64/x86）与DLL不匹配，须通过“设置→导入→导入插件”加载对应版本DLL；格式化失效多因未手动设Language→SQL，且需正则预处理混合内容、中文注释及引号内换行问题。
SQLinForm 插件装不上？先看 Notepad++ 架构和 DLL 是否匹配
Notepad++ v8.x 中，SQLinForm 不走 Plugin Manager，手动导入 DLL 是唯一可靠路径。但 90% 的“装了没反应”问题，根源在架构错配——不是系统是 x64 就代表 Notepad++ 是 x64，必须进 帮助 → 关于 Notepad++ 看右下角明确标注的 x64 或 x86。
对应下载地址只认这个标识：官网提供的 SQLinFormNpp64.dll 仅适用于 Notepad++ x64 版；SQLinFormNpp32.dll 才配 x86 版。拖进 plugins 目录不生效，是因为 v8.x 强制要求通过 设置 → 导入 → 导入插件 加载，否则 DLL 不被注册。
- 点
Plugins → SQLinForm菜单不存在？说明导入失败或架构不匹配 - 菜单存在但
Format Selection灰色？检查是否已手动设Language → SQL - 点完无响应且无报错？大概率 DLL 被杀毒软件拦截，临时禁用后重试
格式化后 SQL 全挤在一行？Language → SQL 没点是硬伤
SQLinForm 不会自动识别语言模式，它完全依赖 Notepad++ 当前文档的语言设置。如果文档语言是 Normal text 或 PHP，插件就把 WHERE 当普通单词处理，缩进逻辑彻底失效，结果就是所有关键字被压成一行、括号不换行、子查询无层级。
必须手动操作一次：Language → S → SQL（注意不是“SQL*Plus”或“PL/SQL”，就选纯 SQL）。这步触发关键字着色、括号匹配、语法块识别，后续所有格式化才有基础。
- 混合内容（如含
<!-- HTML 注释 -->或console.log("SELECT ...")）不能选中整段交由SQLinForm处理，会直接跳过 - UTF-8 with BOM 编码下中文注释可能被截断，建议保存为 UTF-8（无 BOM）再格式化
- 若脚本含大量
/*+ hint */提示，SQLinForm默认不识别，需提前用正则把/*+替换为--+避免解析中断
中文注释消失、单引号内换行错乱？得靠正则预清洗
SQLinForm 的默认解析器不处理中文注释（-- 中文、/* 中文 */），也不保护字符串字面量里的换行和逗号。典型现象：格式化后 'SELECT * FROM t' 被拆成三行，-- 查询用户信息 变成 -- 查询用户信息)（末尾多出括号）。
解决办法不是调配置，而是用 Search → Replace 做两轮正则预处理：
- 查找：
(FROM|WHERE|JOIN|ON|GROUP BY|ORDER BY|SELECT|INSERT INTO|UPDATE|DELETE FROM)，替换为：\r\n$1—— 强制关键子句独占一行 - 查找：
(,)(?!\s*['"])，替换为：,\r\n—— 只对非引号内的逗号换行，避开'a,b', "c,d" - 处理完再全选 →
Tab（触发NppAutoIndent）或交由SQLinForm → Format Selection
大文件（>5MB）或深度嵌套子查询卡死？换 NppAutoIndent + 正则组合技
SQLinForm 在 500 行以上脚本中可能出现延迟或内存溢出，尤其当子查询嵌套超 5 层、含大量 CTE 或动态 SQL 字符串时。此时 Plugins → SQLinForm → Format All 容易无响应，但 NppAutoIndent 插件不解析语义，只按括号和关键字缩进，天生适合大文件。
它不提供按钮，但接管 Tab 键行为，配合前述正则预处理，效果稳定：
- 确保语言已设为
SQL（否则括号不匹配，缩进全乱） - 执行两次正则替换（同上节），让每个子句、每组字段、每个条件都处于独立行
- 全选代码，按
Tab——SELECT子句缩进 2 级，WHERE内条件缩进 3 级，AND/OR对齐上一行，且完全不碰单引号、双引号、中文注释内容
真正难处理的从来不是格式化动作本身，而是混合编码、跨语言块、未转义引号这些边界情况——它们不会报错，但会让格式结果不可读。每次处理前花 10 秒确认语言模式、扫一眼是否有 /*+ 或 ' 里藏逗号，比重跑三遍格式化更省时间。
