Notepad++ 主题文件必须放在 %APPDATA%\Notepad++\themes\ 目录（安装版优先读此路径），便携版则只认程序根目录下的 themes 文件夹；文件需为 UTF-8 编码、含 <?xml ... ?> 声明、根节点 <NotepadPlus>、至少一个 <Theme name="xxx"> 及 <WordsStyle name="DEFAULT">，且文件名不能含空格或中文。
主题文件放哪，Notepad++ 才认得
Notepad++ 加载主题时优先读 %APPDATA%\Notepad++\themes\，不是安装目录下的 themes。装完一个自定义主题却在“设置 → 语言格式设置 → 主题”下看不到，八成是放错了位置。便携版例外——它只认程序根目录下的 themes 文件夹，%APPDATA% 完全不生效。
确认路径是否正确：按 Win + R，粘贴 %APPDATA%\Notepad++\themes 回车。如果该文件夹不存在，手动新建；若存在但为空，说明你之前装的主题全进了安装目录，白忙活。
常见错误现象：
• 放进 C:\Program Files\Notepad++\themes\ 却没反应
• 文件名带空格或中文（如 我的夜间主题.xml），导致加载失败
• XML 文件没有放在 themes 子目录里，而是丢在了 %APPDATA%\Notepad++\ 根目录
XML 主题文件必须包含哪些字段才生效
Notepad++ 的主题 XML 不是随便写几个颜色就能用的。它必须有合法的根节点 <NotepadPlus>，且至少包含一个 <Theme name="xxx"> 节点，内部要有 <WordsStyle name="DEFAULT" ... /> 和对应语言的样式定义（比如 <LexerType name="python">）。缺任意一项，主题可能显示为灰色不可选，或切换后编辑区背景不变。
最小可用结构示例：
<NotepadPlus>
<Theme name="NightCode">
<WordsStyle name="DEFAULT" fgColor="F8F8F2" bgColor="282A36" fontName="" fontStyle="0" fontSize=""/>
<LexerType name="null">
<WordsStyle name="DEFAULT" fgColor="F8F8F2" bgColor="282A36"/>
</LexerType>
</Theme>
</NotepadPlus>
关键点：
• bgColor 和 fgColor 值为 6 位十六进制（不带 #）
• name="DEFAULT" 是全局样式入口，漏掉就等于没设背景
• LexerType name="null" 控制未识别语言的背景，必须配，否则纯文本区域还是白底
改完主题，为什么注释/字符串还是刺眼
主题 XML 只管“样式容器”，不管“语法高亮逻辑”。你设了深灰背景，但 Python 字符串默认还是亮黄 ffcc33，在暗背景下就像闪光弹。真正起作用的是 stylers.xml 里的具体语言样式，它和主题文件是两套系统。
解决方法分两步：
• 在“设置 → 样式配置器”里，左侧选语言（如 Python），右侧逐项点开 String、Comment、Keyword，手动调低饱和度、提高明度（例如注释用 9cdcfe，关键字用 569cd6）
• 若想批量生效，直接编辑 %APPDATA%\Notepad++\stylers.xml，找到对应 LexerType 节点，修改每个 WordsStyle 的 fgColor 和 bgColor
• 切记：改 stylers.xml 前必须关闭 Notepad++，否则重启后会被自动覆盖
UDL（用户定义语言）和自定义主题不联动怎么办
你调好了 Python、XML、JSON 的所有高亮，结果打开自己写的 markdown.custom.udl.xml，背景又变回惨白——这是 Notepad++ 的设计限制：UDL 的样式完全硬编码在自己的 XML 文件里，不继承任何主题或 stylers.xml 设置。
必须手动同步：
• 打开 %APPDATA%\Notepad++\userDefineLangs\ 下你的 UDL 文件
• 找到每个 <WordsStyle> 标签，把 fgColor 和 bgColor 改成和主题一致的值（如 bgColor="282A36"）
• 特别注意 <LexerType name="userDefineLang_1"> 这类节点名，不同 UDL 编号不同，别改错块
• 改完保存，重启 Notepad++，否则 UDL 不重载
这个环节最容易被忽略：主题看着很酷，一写自定义语法就破功。不是主题没做好，是 UDL 还在用自己的旧配色。
