如何在 Jupyter Notebook 配置文件里添加自定义 CSS

畫卷琴夢

畫卷琴夢

2026-08-05

875人浏览

原创

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

如何在 jupyter notebook 配置文件里添加自定义 css

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应用程序 英文文字pdf版附源文件
使用HTML,CSS,JavaScript开发Android应用程序 英文文字pdf版附源文件

如果你了解HTML,CSS和JavaScript,您已经拥有所需的工具开发Android应用程序。本动手本书展示了如何使用这些开源web标准设计和建造,可适应任何Android设备的应用程序 - 无需使用Java。您将学习如何创建一个在您选择的平台的Andr​​oid友好的网络应用程序,然后转换与自由PhoneGap框架到一个原生的Andr​​oid应用程序。了解为什么设备无关的移动应用是未来的潮流,并开始构建应用程序,提供更

下载

即使重启,浏览器也可能缓存旧样式:

  • 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-blueonedork.less 里定义,换主题就得重调)。

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关专题

更多
css
css

css是层叠样式表,用来表现HTML或XML等文件样式的计算机语言,不仅可以静态地修饰网页,还可以配合各种脚本语言动态地对网页各元素进行格式化。php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

1913

6

css居中
css居中

css居中:1、通过“margin: 0 auto; text-align: center”实现水平居中;2、通过“display:flex”实现水平居中;3、通过“display:table-cell”和“margin-left”实现居中。本专题为大家提供css居中的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.27

491

5

css如何插入图片
css如何插入图片

cssCSS是层叠样式表(Cascading Style Sheets)的缩写。它是一种用于描述网页或应用程序外观和样式的标记语言。CSS可以控制网页的字体、颜色、布局、大小、背景、边框等方面,使得网页的外观更加美观和易于阅读。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.28

1232

6

css超出显示...
css超出显示...

在CSS中,当文本内容超出容器的宽度或高度时,可以使用省略号来表示被隐藏的文本内容。本专题为大家提供css超出显示...的相关文章,相关教程,供大家免费体验。

2023.08.01

1826

7

css字体颜色
css字体颜色

CSS中,字体颜色可以通过属性color来设置,用于控制文本的前景色,字体颜色在网页设计中起到很重要的作用,具有以下表现作用:1、提升可读性;2、强调重点信息;3、营造氛围和美感;4、用于呈现品牌标识或与品牌形象相符的风格。

2023.08.10

3028

11

什么是css
什么是css

CSS是层叠样式表(Cascading Style Sheets)的缩写,是一种用于描述网页(或其他基于 XML 的文档)样式与布局的标记语言,CSS的作用和意义如下:1、分离样式和内容;2、页面加载速度优化;3、实现响应式设计;4、确保整个网站的风格和样式保持统一。

2023.08.10

2514

7

css三角形怎么写
css三角形怎么写

CSS可以通过多种方式实现三角形形状,本专题为大家提供css三角形怎么写的相关教程,大家可以免费体验。

2023.08.21

1128

9

css设置文字颜色
css设置文字颜色

CSS(层叠样式表)可以用于设置文字颜色,这样做有以下好处和优势:1、增加网页的可视化效果;2、突出显示某些重要的信息或关键字;3、增强品牌识别度;4、提高网页的可访问性;5、引起不同的情感共鸣。

2023.08.22

1302

5

css禁止点击事件
css禁止点击事件

实现css禁止点击事件的方法有使用CSS的pointer-events属性和使用JavaScript禁用点击事件。本专题为大家提供点击事件相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

940

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Jupyter Notebook官方文档
Jupyter Notebook官方文档

共0课时 | 0人学习

Sass 教程
Sass 教程

共14课时 | 1.3万人学习