Notepad++ 自定义主题加载失败主因是路径错误、文件名含非法字符、XML 编码非 UTF-8 无 BOM 或结构不合规；须放至 %APPDATA%\Notepad++\themes\（便携版为同级 themes\），文件名仅限 ASCII 字母数字及下划线短横线，XML 必须以 开头且根节点为 并含 或 。
Notepad++ 自定义主题加载失败，90% 是路径、文件名或 XML 结构不合规导致的静默忽略——它不会报错，也不会在“样式配置器”里显示名字，只当没这回事。
主题文件必须放对位置且文件夹存在
Notepad++ 不会自动创建 themes 目录，也不接受任何其他路径。放错地方，重启后完全无反应。
- 正确路径是：
%APPDATA%\Notepad++\themes\（Windows 10/11），即C:\Users\用户名\AppData\Roaming\Notepad++\themes\ -
AppData是隐藏文件夹，别在资源管理器里手动找；直接在地址栏粘贴完整路径回车即可打开 - 如果
themes文件夹不存在，需**手动新建**，不能靠 Notepad++ 自动生成 - 便携版用户注意：路径是 notepad++.exe 同级的
themes\，不是plugins\themes\或根目录
XML 文件名和编码必须严格合规
文件名含空格、中文或非法字符，或保存为带 BOM 的 UTF-8，都会导致解析中断，主题彻底不加载。
- 文件名只能含 ASCII 字母、数字、下划线、短横线，例如：
Dracula.xml✅，My Theme.xml❌，暗色主题.xml❌ - 必须用记事本或 Notepad++ 自身另存为「UTF-8 无 BOM」格式（Notepad++ 菜单：编码 → 转为 UTF-8 无 BOM）
- 开头必须有合法声明：
<?xml version="1.0" encoding="UTF-8"?> - 根节点必须是：
<notepadplus></notepadplus>，且至少包含一个<globalstyles></globalstyles>或<lexertype></lexertype>子节点
导入后不显示在样式配置器？检查语言绑定和 fallback 行为
主题文件进了 themes\ 目录 ≠ 主题自动生效。Notepad++ 不像 VS Code 那样全局启用，它需要你手动绑定到具体语言，且依赖 fallback 逻辑。
- 重启 Notepad++ 后，进
设置 → 样式配置器，左侧 Language 下拉菜单**不能选 Global**，要选具体语言（如Python、JSON、XML） - 右侧“选择主题”下拉框里找不到你的主题？说明 XML 结构不合法——用 Notepad++ 打开该 .xml 文件，顶部若出现红色 XML 解析错误，就证明格式不对
- 很多主题只定义了
<globalstyles></globalstyles>，但没覆盖<lexertype name="ini"></lexertype>这类小众语言，结果打开.ini文件时文字发灰，其实是 fallback 到了默认浅灰前景色 - 确认当前文档右下角状态栏显示的是对应语言（如
INI file），不是Normal text；否则样式配置器根本不会应用你选的主题
高对比度主题文字看不清？别只调背景色
深色主题失效最典型的表象是：背景变黑了，但字符串、注释还是浅灰色，在深色背景下几乎隐形。这不是主题坏了，是样式层级没配齐。
- Notepad++ 样式分三层：
GlobalStyles（兜底）、LexerStyles（按语言定义）、WidgetStyle（界面控件）。只改GlobalStyles的bgColor，不碰各语言的fgColor，必然出问题 - 进样式配置器，左侧选
Python，右侧点开STRING、COMMENT、KEYWORD等项，逐个确认Foreground colour值是否与你设的背景色构成足够对比（推荐亮度差 ≥120） - 若某语言没单独设置，它会 fallback 到
GlobalStyles的fgColor，所以GlobalStyles的fgColor也得设成高对比值，比如#F8F8F2，而不是#CCCCCC - GUI 调不动时，直接编辑
stylers.xml更可靠——但它不是主题文件，改完必须**彻底关闭所有 Notepad++ 进程再重开**，热加载不生效
最容易被忽略的一点：每次 Notepad++ 升级（尤其是 v8.6+）都可能重写 stylers.xml，导致你手动调好的颜色被覆盖。不要把所有希望押在 GUI 配置上，关键配色建议固化在主题 XML 里，并定期验证 themes\ 下的文件是否仍被读取。
