Jupyter Notebook 默认的白色界面在长时间工作下容易导致视觉疲劳，且默认字体对代码的可读性支持有限。通过开源工具 jupyter-themes，开发者可以快速切换深色模式、调整字体大小以及优化页面布局，从而提升编码体验。本文将详细介绍该工具的安装、核心命令及高级自定义配置。

1. 环境安装与基础操作

jupyter-themes 适配 Python 环境，可以通过 pip 或 conda 进行安装：

# 使用 pip 安装
pip install jupyterthemes

# 或者使用 conda
conda install -c conda-forge jupyterthemes

# 更新至最新版本以获取最新样式
pip install --upgrade jupyterthemes

安装完成后，可以通过命令行列出当前支持的所有主题模板：

jt -l

执行后会返回可用主题列表，如：onedork、grade3、oceans16、chesterish、monokai、solarizedl 和 solarizedd。

要应用某个特定主题，例如 oceans16，执行以下命令：

jt -t oceans16

2. 进阶参数配置

jupyter-themes 允许用户通过复杂的参数组合来定制界面的每一个细节。下表列出了最常用的配置选项：

参数	说明	常用取值示例
-f	代码字体	code, fira, hack, ubuntu
-fs	代码字号	11, 12 (默认 11)
-nf	Notebook 界面字体	opensans, merriweather
-nfs	界面字号	12, 13
-cellw	单元格宽度	90%, 1200
-T	显示工具栏	(开关参数)
-N	显示文件名	(开关参数)
-cursc	光标颜色	b (蓝), r (红), p (紫)

常用配置方案示例

深色高性能模式： 适合长时间编写算法，开启工具栏并调整代码宽度。

jt -t monokai -f fira -fs 13 -cellw 90% -ofs 11 -dfs 11 -T -N

明亮阅读模式： 适合展示数据报告或撰写文档，使用浅色背景和较大的行间距。

jt -t grade3 -nf opensans -nfs 12 -lineh 180 -cellw 85%

3. 统一图表风格

界面美化后，Matplotlib 默认生成的图片可能会因为背景色不一致而显得突兀。通过 jtplot 模块，可以将绘图风格与主题完美融合。

from jupyterthemes import jtplot
import matplotlib.pyplot as plt
import numpy as np

# 设置绘图风格为 onedork
jtplot.style(theme='onedork', context='notebook', ticks=True, grid=False)

# 生成示例图表
data_x = np.linspace(0, 10, 50)
data_y = np.exp(data_x / 3)
plt.plot(data_x, data_y, label='Growth Curve')
plt.legend()
plt.show()

4. 常见问题与恢复

• 主题未立即生效： 应用命令后，请强制刷新浏览器页面（通常是 Ctrl + F5）。如果依旧无效，请尝试重启 Jupyter Notebook 服务。
• 恢复原始默认主题： 如果需要切回 Jupyter 默认的简洁白色界面，只需运行以下命令并重启：

jt -r

在进行大规模主题定制时，建议先备份当前的配置文件。此外，虽然 jupyter-themes 对 Notebook 6.x 支持良好，但在较新的 JupyterLab 中，其功能受限，建议在传统的 Notebook 环境中使用。