jt命令可直接切换jupyter主题,无需修改css或安装插件,但必须重启jupyter才能生效;安装用pip install jupyterthemes,升级用--upgrade,jt -l列出主题,jt -t主题名配合-f、-fs、-cellw等参数定制样式,jt -r恢复默认。

直接用 jt 命令就能换主题,不用改 CSS 文件、也不用装插件——但必须重启 Jupyter 才生效,否则白配。
安装和列出可用主题
先确认 jupyterthemes 已安装:pip install jupyterthemes。如果已装过,建议升级:pip install --upgrade jupyterthemes。运行 jt -l 查看所有内置主题,输出类似:
Available Themes: chesterish grade3 gruvboxd gruvboxl monokai oceans16 onedork solarizedd solarizedl
注意:这些主题分深色/浅色系(如 gruvboxd 是深色,gruvboxl 是浅色),别只看名字猜效果;oceans16 和 monokai 是最常用的深色主题。
应用主题并控制关键显示参数
换主题不是只输 jt -t xxx 就完事。默认参数常导致代码挤在一起或字体太小,必须连带调整:
-
-f指定代码区字体(推荐fira或roboto,Windows 用consolas更稳) -
-fs控制代码字体大小(-fs 13比默认 11 更易读) -
-cellw设单元格宽度(-cellw 90%避免左右滚动,别用像素值如980,高分屏会糊) -
-lineh调行高(-lineh 170防止行间粘连) -
-T显示工具栏,-N显示 notebook 名称(不加这两项,UI 会突然“变空”)
完整命令示例:jt -t monokai -f fira -fs 13 -cellw 90% -lineh 170 -T -N。执行后必须关闭所有 Jupyter 进程再重新启动,否则样式不加载。
重置或回退到默认主题
想撤回?别手动删文件,直接运行:jt -r。它会还原所有 CSS 和配置,但不会动你自己的 custom.css。如果执行后界面仍异常,说明浏览器缓存了旧样式,强制刷新(Ctrl+Shift+R)或清空缓存。
常见翻车点:在没关 Jupyter 的情况下反复执行 jt -t xxx,会导致 CSS 冲突,页面空白或错位;还有人把 -cellw 写成 -cell-w(多横线),命令静默失败,主题根本没换。
自定义颜色要改 custom.css,但得小心覆盖
如果预设主题都不合心意(比如想把 monokai 的注释绿色改成青色),就得编辑 ~/.jupyter/custom/custom.css。注意两点:
- 路径中的
~是用户主目录(Windows 是C:\Users\用户名\.jupyter\custom\custom.css) - 写 CSS 时优先用类名前缀
.cm-s-ipython(如.cm-s-ipython span.cm-comment),避免影响其他组件 - 改完保存,同样要重启 Jupyter + 强刷页面,
custom.css不会热更新
真正麻烦的不是换颜色,而是不同主题对 CSS 类名的继承逻辑不一样——gruvboxd 和 solarizedd 修改同一项可能需要不同选择器,建议先用浏览器开发者工具定位元素,再下笔改。











