PythonScript插件不支持断点调试，只能通过print、console.write()或notepad.messageBox()输出日志；需将核心逻辑抽离为独立.py文件，在外部Python环境用VS Code/PyCharm调试，避免依赖Notepad++运行时。
PythonScript 插件本身不支持断点调试
Notepad++ 的 PythonScript 插件本质是把 Python 解释器嵌进进程里，直接执行脚本，没有集成调试器。你不能像 VS Code 那样在 editor.getText() 前打个断点、按 F5 单步走。所有 print()、notepad.messageBox()、console.write() 都是“输出即日志”，没有暂停、变量监视、调用栈回溯这些能力。
常见错误现象包括：脚本运行后没反应、notepad.prompt() 不弹窗、editor.replace() 替换失败但也不报错——这些问题往往卡在对象状态（比如当前文档是否被激活）、编码隐式转换（ANSI vs UTF-8）、或路径中含中文导致 open() 报 UnicodeDecodeError，但控制台不显示 traceback。
- 必须手动加
console.show()和console.clear()开头，否则print()输出可能被忽略 -
notepad.messageBox()是唯一能阻塞执行的调试手段，适合验证某段逻辑是否走到 - 避免在脚本末尾写
input()—— Notepad++ 进程不接管 stdin，会直接卡死
用外部 Python 环境 + print 日志做真调试
如果你需要观察变量值、复现条件分支、查 Unicode 错误堆栈，最可靠的方式是把核心逻辑抽成独立 .py 文件，在外部终端里跑。这样你能用 python -i script.py 进入交互模式，或者用 VS Code/PyCharm 附加调试器。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 把脚本主体封装成函数，例如
def process_current_file(editor): ...，并在顶部加if __name__ == '__main__':分支模拟 editor 对象 - 用
sys.argv或硬编码测试文本代替editor.getText()，避免依赖 Notepad++ 运行时环境 - 在 Notepad++ 中保留一个最小壳：
from my_utils import process_current_file; process_current_file(editor)，只负责桥接
这样改一行逻辑，外部终端 python test.py 就能立刻看到完整 traceback，比在 PythonScript 控制台里反复删 print 高效得多。
nppexec 调用外部 Python 时的编码陷阱
很多人用 nppexec 配置 python "$(FULL_CURRENT_PATH)" 来运行脚本，结果中文路径或中文内容一读就崩，报错信息是 UnicodeEncodeError: 'gbk' codec can't encode character 或更隐蔽的 FileNotFoundError（其实是路径 decode 失败）。
根本原因：Windows 控制台默认用 GBK 编码，而 Notepad++ 传给 nppexec 的 $(FULL_CURRENT_PATH) 是 UTF-8 字节序列，两者不匹配。
- 临时解法：在命令前加
chcp 65001 &切到 UTF-8 模式，例如：chcp 65001 & python "$(FULL_CURRENT_PATH)" - 长期解法：改用绝对路径调用 Python，并显式指定文件编码，例如：
python -c "import sys; sys.stdout.reconfigure(encoding='utf-8'); exec(open(r'$(FULL_CURRENT_PATH)', encoding='utf-8').read())" - 别信网上教程里写
cmd /k python ... & PAUSE——PAUSE在中文 Windows 下常因编码问题卡住，且无法捕获异常输出
为什么不用 PyNPP 或其他“一键运行”插件
PyNPP 等插件本质是包装了 nppexec 流程，没解决底层编码和上下文隔离问题。它会在后台起一个新进程跑 Python，但不会同步 Notepad++ 当前文档的编码设置，也不会把 editor 对象注入进去——所以你依然没法在脚本里调用 editor.getSelection() 这类 API。
真正需要调试的是操作 Notepad++ 自身状态的逻辑（比如批量处理多个标签页、根据当前光标位置插入文本），这类代码只能靠 PythonScript 插件加载；而纯数据处理逻辑（解析 JSON、生成 CSV、正则清洗），应该拆出去用标准 Python 跑。
容易被忽略的一点：Notepad++ 启动时加载的 PythonScript 脚本，其工作目录是 Notepad++ 安装路径，不是当前文件所在目录。所以 open('config.txt') 会去 C:\Program Files\Notepad++\config.txt 找，而不是你编辑的文件夹。这个路径偏差，90% 的“找不到文件”错误都源于此。
