直接换深色主题最省事,用jupyterthemes一行命令生效,但仅兼容经典Notebook;安装失败时需换清华镜像源并加trusted-host参数;选主题注意-t、-f、-cellw等参数冲突;换主题后须重启Jupyter服务且确保环境正确;输出区白底等问题需手动编辑custom.css解决。

直接换深色主题最省事,用 jupyterthemes 一行命令就能生效,不需要改 CSS 或装浏览器插件——但得注意它不兼容 JupyterLab,只对经典 Notebook 有效。
安装 jupyterthemes 失败怎么办
常见现象是 pip install jupyterthemes 卡住或报 timeout 错误,本质是 PyPI 默认源在国内访问不稳定。
- 换成国内镜像源安装:运行
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ jupyterthemes - 如果仍失败,加
--trusted-host pypi.tuna.tsinghua.edu.cn参数重试 - 确认安装成功后,终端输入
jt -l能列出主题列表才算到位
选主题时要注意哪些参数冲突
jt 命令里一堆短参数看着眼花,其实核心就三个:主题、字体、宽度。其他参数容易互相打架。
-
-t monokai这类主题名必须存在,用jt -l查准名字,别拼错(比如monokai不是mono-kai) -
-f fira指定的字体必须系统已安装,否则 fallback 到默认字体,-fs 14才会真正生效 -
-cellw 90%和-T(显示工具栏)同时用可能让代码区变窄,建议先去掉-T测试宽度效果
换完主题没变化?重启和路径是关键
这不是缓存问题,而是 jupyterthemes 把 CSS 写进用户目录下的静态资源里,Jupyter 启动时才加载。
- 必须关闭所有
jupyter notebook进程,再在终端重新执行jupyter notebook - 不要点浏览器刷新按钮,要关掉整个服务再启动
- 如果用了 Anaconda,确保你在 base 环境或对应环境中执行命令,虚拟环境里没装
jupyterthemes就不会生效
真正麻烦的不是换主题,而是你改完发现输出区域(div.output_subarea)还是白底,或者行号颜色被盖掉——这时候就得去 ~/.jupyter/custom/custom.css 手动补几行 CSS,而不是再跑一遍 jt 命令。


















