如何使Jupyter Lab适配Jupyter Notebook的onedork主题？安装后失效求解

数据老陈

2026-6-21

解决方案：Jupyter Lab匹配OneDork主题+自定义深色配色

一、Jupyter Lab适配Notebook的OneDork主题

Jupyter Themes（jt命令）仅针对经典Jupyter Notebook设计，和Jupyter Lab的前端架构不兼容，需使用Lab专属的主题扩展：

卸载可能冲突的旧版Jupyter Themes：
```
pip uninstall jupyterthemes -y
```
安装Lab版OneDork主题：
```
pip install jupyterlab-theme-onedork
```
重建Lab前端（Lab 3.x及以上版本可跳过，但建议执行确保生效）：
```
jupyter lab build
```
启用并配置主题：
- 打开Jupyter Lab，点击左侧齿轮图标 → Settings → Theme，选择OneDork
- 调整字体与工具栏：进入Settings → Advanced Settings Editor → Notebook，在User Preferences中添加：
```
{
  "fontSize": 12,
  "outputFontSize": 12,
  "toolbar": {
    "visible": true
  }
}
```
保存后即可匹配原!jt -t onedork -fs 12 -ofs 12 -T的效果。

二、修复更新后OneDork主题失效问题

若Lab版本更新后主题无法加载，大概率是扩展版本不兼容，可按以下步骤修复：

查看当前Lab版本：
```
jupyter lab --version
```
安装适配当前Lab版本的主题包，优先更新到最新版：
```
pip install --upgrade jupyterlab-theme-onedork
```
清理Lab缓存并重建：
```
jupyter lab clean
jupyter lab build
```

三、自定义内置深色主题的纯黑配色

若觉得内置深色主题背景过于压抑，可自定义配色：

进入Settings → Advanced Settings Editor → Theme

在右侧User Preferences中添加自定义CSS变量（示例用深灰替代纯黑，可自行调整色值）：

{
  "overrides": {
    "background-color": "#1e1e1e",
    "notebook-container-background": "#1e1e1e",
    "toolbar-background": "#2d2d2d",
    "code-cell-background": "#252525"
  }
}