jupyterthemes 是最稳定兼容的深色主题方案，支持全平台，安装推荐清华镜像源，深色主题含 gruvboxd 等 6 种，需完全重启 Notebook 进程生效，不支持 JupyterLab，可通过命令行参数微调字体、行高、宽度等样式。
jupyterthemes 是目前最稳定、兼容性最好的深色主题方案，不用改 CSS 文件，也不依赖浏览器插件。直接装包、选主题、重启即可生效，Windows/macOS/Linux 全平台支持。
安装 jupyterthemes 时 pip 失败或报错
常见错误是网络超时或 SSL 验证失败（尤其在国内）。别硬等 pip 默认源：
- 优先用清华镜像：运行
pip install jupyterthemes -i https://pypi.tuna.tsinghua.edu.cn/simple/ - 如果提示
PermissionError，加--user参数：pip install --user jupyterthemes -i https://pypi.tuna.tsinghua.edu.cn/simple/ - conda 用户建议用
conda install -c conda-forge jupyterthemes，比 pip 更少冲突 - 装完后运行
jt -h能输出帮助说明，才算真正装成功
jt -l 列出的主题里没有深色选项
不是没有，而是你没看清——9 个内置主题中，gruvboxd、oceans16、monokai、solarizedd、onedork、chesterish 都是深色系。浅色主题只有 grade3 和 solarizedl（淡粉）两个。
- 推荐新手直接试
jt -t oceans16：蓝灰底 + 白字 + 柔和语法高亮，护眼且不刺眼 - 想更暗一点就用
jt -t gruvboxd，但注意它默认字体偏小，建议同步加-fs 13 -
jt -l输出的列表末尾如果有(default)标记，那是当前已启用的主题，不是“默认白色”
换完主题没变化，或者只变了一半
这是最常被忽略的步骤：Jupyter Notebook 进程必须完全重启，不是刷新页面，也不是关掉 tab 再开。
- 先关闭所有
jupyter notebook进程（包括后台的 Python 进程，Windows 可用任务管理器查python.exe） - 再重新运行
jupyter notebook命令启动 - 如果用了 JupyterLab，
jupyterthemes不生效——它只支持 classic Notebook，Lab 需另装@jupyterlab/theme-dark - 极少数情况是缓存问题：清空浏览器缓存，或尝试无痕窗口打开
想微调颜色但不想写 CSS
jupyterthemes 自带命令行参数就能改关键样式，比手动编辑 custom.css 更安全：
- 改代码区字体大小：
jt -t oceans16 -fs 14（-fs是 code cell 字号） - 同时改输出区字号：
-dfs 12（避免输出文字太小看不清） - 加行高防拥挤：
-lineh 170（单位是 px，150~180 之间最舒适） - 让单元格窄一点留边：
-cellw 85%（别设太窄，否则长变量名会折行难读） - 光标太细看不清？加
-cursw 3 -cursc r（宽 3px，红色光标）
所有参数必须一次写全，分两次执行只会保留最后一次的设置。
