Notepad++跨文件正则替换需同时满足绝对路径、严格分号分隔的过滤器、统一编码、$1反向引用四要素，缺一即显示0匹配却不报错；Ctrl+Shift+F是唯一入口，不处理打开标签页，路径末尾勿加反斜杠，过滤器空则扫描全部文件，编码不一致导致跳过或乱码，$1不可写作\1。
Notepad++ 跨文件正则替换不是“点一下就全改”，而是必须填对绝对路径、写严过滤器、设准编码、用对 $1，缺一不可；否则显示 0 occurrence(s) found 却实际有内容，且不报错。
Ctrl+Shift+F 是唯一入口，路径必须是绝对路径
「在文件中查找」（Ctrl+Shift+F）不读取当前打开的标签页，也不解析 ./src、src/ 或空值。填错等于没操作，状态栏只默默显示 0，不提示、不警告。
- 正确写法：
C:\myproject\src（结尾不加反斜杠更稳妥） - 含中文或空格的路径无需引号，新版 Notepad++ 已兼容
- OneDrive 或 WSL 挂载路径（如
\wsl$\Ubuntu\home\user\proj）需确认 Notepad++ 进程有读权限——管理员运行不一定有效 - 路径末尾带括号（如
C:\2024(backup)）不用转义，这不是正则区域
文件过滤器必须用英文分号严格分隔
过滤器不是“建议”，而是硬性白名单。格式错一个字符，整个扫描就被静默关闭。
- ✅ 正确：
*.js;*.ts;*.html - ❌ 无效：
*.js, *.ts（逗号）、*.js *.ts（空格）、*.js; *.ts（分号后空格） - 不支持
**/*.js或排除语法（如!node_modules）；想跳过某目录，只能手动移出或清空过滤器再预览 - 过滤器为空 = 扫描所有文件，包括
.git/config、package-lock.json—— 务必先点「查找全部」预览匹配项
编码不一致会导致“找到但没替换”或乱码
Notepad++ 在 Ctrl+Shift+F 中统一用右下角状态栏显示的编码去解析所有目标文件。混着 UTF-8、GBK、ANSI 的一批文件，部分中文根本进不了匹配引擎。
- 右下角显示
ANSI，但你要处理的是 UTF-8 文件？替换后大概率出现???或直接跳过 - 临时解法：菜单「编码 → 转为 UTF-8-BOM」批量转存（注意 BOM 可能影响某些构建工具）
- 正则替换含中文时，
查找内容和替换为必须用相同编码输入，别复制粘贴来源不明的文本 - 换行符不一致也会影响多行匹配：
\r\n才能匹配 Windows 的 CRLF；\R是 Notepad++ 内置通用换行符（等价于\r\n|\n|\r），比盲目勾选“.”更可靠
正则跨文件替换必须用 $1，不能用 \1
在「在文件中查找」面板启用正则模式后，捕获组的反向引用语法固定为 $1、$2。\1 在新版 Notepad++ 中已失效且不生效。
-
$0表示整个匹配项，$1是第一个()里的内容，编号按左括号顺序递增 - 例如重构变量前缀：
查找: tmp_(\w+)→替换: cache_$1 - 又如路径升级：
查找: api/v1/(\w+)→替换: api/v2/$1 - 扩展模式（
.、^等）不支持$1，必须切到「正则表达式」模式才能用捕获组
最常被忽略的是编码和过滤器格式——它们不出错，但让替换彻底失效；而 $1 写成 \1 会安静地什么也不做。批量改完不保存也是默认行为，得手动点每个文件的保存按钮，或者用插件辅助。
