custom.css文件唯一生效路径是~/.jupyter/custom/custom.css(linux/macos)或%userprofile%.jupyter\custom\custom.css(windows),需手动创建custom目录,文件名必须为custom.css,且修改后须重启jupyter服务并清除浏览器缓存。

custom.css 文件在哪?先确认路径是否正确
自定义 CSS 生效的唯一位置是 ~/.jupyter/custom/custom.css(Linux/macOS)或 %USERPROFILE%\.jupyter\custom\custom.css(Windows)。这个路径由 Jupyter 自身决定,不是你随便建个 custom.css 就能生效的。
常见错误是把 CSS 放到:notebook/static/custom/custom.css(旧版路径,已废弃)、jupyterthemes/styles/compiled/(只读编译目录)、或者当前项目根目录下——这些位置都不会被 Jupyter 加载。
- 运行
jupyter --config-dir查看真实配置目录,再拼出custom/custom.css路径 - 如果
custom/目录不存在,手动创建它(不要用jt -f强制覆盖,那会清空你手写的样式) - 文件必须叫
custom.css,不能是style.css或带版本号的名称
写什么 CSS 才能生效?注意选择器权重和加载时机
Jupyter 的 DOM 结构嵌套深、默认样式多,直接写 blockquote { background: #eee; } 很可能被忽略。必须提高选择器 specificity 或加 !important(谨慎但必要)。
例如,要改块引用背景色,得这样写:
div#notebook div.text_cell_render blockquote {
background-color: #f8f9fa !important;
border-left: 4px solid #007bff !important;
padding: 0.5em 1em;
}
- 避免用太宽泛的选择器如
blockquote或.text_cell_render单独出现 - 优先复用 Jupyter 现有 class(如
.input_area、.output_subarea),比自己猜结构更可靠 - 修改字体时,
code标签和.CodeMirror区域需分别处理,前者影响 Markdown 中的行内代码,后者控制编辑区
修改后不生效?重启和缓存是两大拦路虎
改完 custom.css 必须重启 Jupyter Notebook 服务(不是刷新页面,而是 Ctrl+C 停掉再 jupyter notebook 启动)。否则旧 CSS 仍驻留在内存中。
如果你了解HTML,CSS和JavaScript,您已经拥有所需的工具开发Android应用程序。本动手本书展示了如何使用这些开源web标准设计和建造,可适应任何Android设备的应用程序 - 无需使用Java。您将学习如何创建一个在您选择的平台的Android友好的网络应用程序,然后转换与自由PhoneGap框架到一个原生的Android应用程序。了解为什么设备无关的移动应用是未来的潮流,并开始构建应用程序,提供更
即使重启,浏览器也可能缓存旧样式:
- Chrome/Firefox:打开开发者工具 → 右键「刷新」按钮 → 选「清空缓存并硬性重新加载」
- 确认 Network 面板里
custom.css返回状态码是 200,且响应内容是你刚保存的最新版本 - 如果用的是 JupyterLab,
custom.css完全不生效(Lab 使用 CSS Variable + Theme JSON,需另配user-settings/@jupyterlab/apputils-extension/themes.json)
想保留主题又加定制?别直接改 jt 生成的 CSS
jt -t onedork 会重写 custom.css,把你手写的样式全冲掉。这不是 bug,是设计如此。
安全做法是:
- 用
jt -t onedork -f应用主题后,立刻复制生成的custom.css内容,粘贴到一个备份文件(如custom-base.css) - 之后所有自定义都写在新文件里,比如
custom-extra.css,再通过 JS 注入(见下条) - 或更简单:每次
jt后,把你的增量样式块(如 blockquote 修改)重新粘贴到custom.css末尾
真正难的不是写 CSS,而是让改动在主题更新、Jupyter 升级、多环境同步时不意外丢失——建议把 custom.css 纳入 Git 版本管理,并在 README 里注明哪些规则依赖特定主题变量(比如 @item-blue 在 onedork.less 里定义,换主题就得重调)。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










