draw.io深色主题可通过五种方式启用：一、修改本地存储中.drawio-config的ui值为'dark'；二、url添加?ui=dark参数；三、用dark reader扩展全局反转；四、vs code插件设drawio: theme为dark；五、清除浏览器缓存重置配置。
如果您在使用 draw.io 时发现界面为刺眼的亮色背景，长时间绘图后出现视觉疲劳，则可能是未启用深色主题模式。以下是针对不同使用场景切换 draw.io 深色主题的多种方法：
一、修改本地配置文件强制禁用亮色UI
draw.io 通过本地存储中的 .drawio-config 配置项控制界面主题，默认值 ui: 'dark' 实际会触发深色渲染；但部分版本或缓存异常可能导致该字段失效或被覆盖为 'light'，需手动修正。
1、在浏览器中按 F12 打开开发者工具，切换至 Application 标签页。
2、在左侧边栏展开 Local Storage，选中当前 draw.io 网址（如 https://app.diagrams.net）。
3、在右侧键值列表中查找 .drawio-config，点击其值进行编辑。
4、将其中 ui 字段的值修改为 'dark'，例如："ui": "dark"。
5、按 Enter 保存，刷新页面即可生效。
二、通过 URL 参数临时启用深色模式
draw.io 支持在启动链接中添加参数直接加载深色主题，无需修改任何配置，适用于临时使用或快速验证效果，且对在线版与嵌入式版本均有效。
1、关闭当前 draw.io 页面。
2、在地址栏输入完整 URL：https://app.diagrams.net/?ui=dark。
3、回车访问，页面将自动以深色主题加载。
4、若需默认从此链接打开，可将该地址设为浏览器书签或快捷方式目标。
三、使用浏览器扩展全局适配深色渲染
当 draw.io 官方 UI 未响应系统深色设置，或嵌入在其他平台（如 Confluence、Notion）中无法直接修改配置时，可通过第三方扩展对整个网页内容进行像素级暗色反转，实现强兼容性护眼效果。
1、访问 Chrome 网上应用店或 Edge 加载项商店，搜索并安装 Dark Reader 扩展。
2、安装完成后，点击浏览器右上角扩展图标，开启 Dark Reader 开关。
3、点击齿轮图标进入设置，在 Site List 中添加 app.diagrams.net 并设为“启用”。
4、在 Filter 模式下调整亮度、对比度与灰度滑块，推荐值为：亮度 95、对比度 85、灰度 0，以保留符号细节并降低眩光。
四、在 VS Code 中启用 drawio 插件深色主题
当使用 vscode-drawio 插件在本地编辑 .drawio 文件时，插件界面会继承 VS Code 当前主题；若 VS Code 已启用深色主题但 drawio 预览仍为亮色，需确保插件配置与编辑器同步。
1、在 VS Code 中按 Ctrl + ,（Windows/Linux）或 Cmd + ,（macOS）打开设置。
2、搜索 drawio theme，找到 Drawio: Theme 设置项。
3、将其值由 default 改为 dark。
4、重启 VS Code 或重新打开 .drawio 文件，预览面板即显示深色背景与高对比度元素。
五、清除浏览器缓存并重置配置状态
旧版配置残留、损坏的本地存储数据可能导致深色主题无法持久化或随机失效，清除缓存可强制 draw.io 重建初始配置，恢复对 ui: 'dark' 的正确解析。
1、在浏览器中按 Ctrl + Shift + Delete（Windows/Linux）或 Cmd + Shift + Delete（macOS）调出清除浏览数据窗口。
2、时间范围选择 所有时间，勾选 Cookies 及其他网站数据 与 缓存的图像和文件。
3、点击 清除数据，等待操作完成。
4、重新访问 https://app.diagrams.net，首次加载时系统将生成全新配置，ui 字段默认为 'dark'。
