最稳的自定义样式方式是直接修改custom.css,它专为覆盖设计、不碰原始文件、重启生效且升级不丢失;路径因安装方式而异,需注意.jupyter/custom/custom.css优先加载;注释字体过小可加span.cm-comment{font-size:14px!important;};编辑区字体需同时设置.codemirror和.codemirror pre;jt换主题后custom.css仍有效;改完须硬刷浏览器缓存。

直接改 custom.css 是最稳的方式
所有自定义样式,优先走 custom.css,它专为覆盖设计,不碰原始文件,重启后即生效,也不会被升级冲掉。路径取决于安装方式:
• Anaconda/Miniconda:通常在 ~/anaconda3/lib/python3.x/site-packages/notebook/static/custom/custom.css(macOS/Linux)或 C:\Users\用户名\Anaconda3\Lib\site-packages\notebook\static\custom\custom.css(Windows)
• pip 全局安装(非 conda):可能在 ~/.local/lib/python3.x/site-packages/notebook/static/custom/custom.css
• 注意:如果 .jupyter/custom/ 下也有 custom.css,它会**优先加载**,容易和上面路径冲突,建议删掉或保持内容一致
span.cm-comment 字体太小?加 font-size 就行
注释文字默认用 CodeMirror 渲染,但多数主题只设了 color,没设大小。直接在 custom.css 末尾加这一行就能生效:
span.cm-comment {
font-size: 14px !important;
}
• !important 必须加,否则会被主题 CSS 覆盖
• 值建议 13–16px,小于 12px 在高分屏上几乎看不清
• 如果连 Markdown 中的 <code> 块里注释也要调,补一句:.rendered_html code { font-size: 14px; }
改代码编辑区字体,别只动 .CodeMirror
只改 .CodeMirror 的 font-family 不够——它只控制编辑器容器,真正显示代码的是里面 pre 标签。必须同时覆盖这两层:
.CodeMirror {
font-family: "Fira Code", "Consolas", monospace;
}
.CodeMirror pre {
font-family: inherit;
font-size: 14px;
line-height: 1.45;
}
• font-family 推荐用等宽字体栈,避免某一种缺失时回退到宋体
• line-height 别设太小(1.6),浪费垂直空间
• 输出区域字体要单独设:div.output_area pre 和 div.input_prompt 都得写
用 jt 换主题时,custom.css 仍有效
jupyter-themes(jt)生成的 CSS 是编译好的,但它的规则优先级低于 custom.css。这意味着:
- 你用
jt -t oceans16换了主题,再在custom.css里写body { background: #f0f0f0; },背景色照常生效 - 想微调某个主题的缺陷(比如
onedork的注释颜色太淡),不用重编译 Less,直接在custom.css里覆盖对应选择器 - 但注意:
jt -r恢复默认后,custom.css依然起作用——它不是主题的一部分,是独立叠加层
真正容易被忽略的是:改完 custom.css 后,浏览器缓存常导致样式不刷新。硬刷(Ctrl+Shift+R)或关掉所有 Notebook 标签页再重开,比重启服务更可靠。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











