Jupyter Notebook怎么设置代码自动折叠

轻伟小哥_4985

轻伟小哥_4985

2026-08-21

251人浏览

原创

jupyter notebook 原生不支持自动折叠,仅提供手动点击或快捷键折叠单个单元格;所谓“自动折叠”需依赖第三方扩展、自定义js或jupyterlab配置间接实现。

jupyter notebook怎么设置代码自动折叠

默认不支持自动折叠,必须手动触发或通过插件/配置启用折叠能力。 Jupyter Notebook 原生只提供「手动点击左侧三角」或「快捷键」折叠单个单元格,没有“运行后自动折叠输出”或“打开时自动折叠代码”的内置开关。所谓“自动折叠”,实际是靠第三方扩展、自定义 JS 或 JupyterLab 的配置项间接实现的。

为什么原生 Notebook 没有 auto-fold 选项

Jupyter Notebook 的折叠逻辑完全由前端 JavaScript 控制,且仅响应用户显式操作(点击、快捷键)。它不会监听 run_cell 事件并自动设置 cell.metadata.collapsed = true,也不读取任何类似 "autoFoldOutput": true 的配置项。所有“自动”效果,都是外部注入行为的结果。

JupyterLab 中开启代码折叠(含自动展开/折叠倾向)

如果你用的是 JupyterLab(推荐),可通过 JSON 设置启用折叠 UI,并控制默认行为:

Jupyter Notebook 7.5.4
Jupyter Notebook 7.5.4

Jupyter Notebook 7.5.4 官方 PyPI wheel 包下载,适合用于本地交互式代码运行、数据分析、教学演示和配置文件实践。

下载
  • 打开 Settings → Advanced Settings Editor → 左侧选 Notebook
  • 在右侧 User Preferences 区域填入:
    {
      "codeCellConfig": {
        "codeFolding": true,
        "autoCollapseOutput": false,
        "autoScrollOnRun": true
      }
    }
  • "codeFolding": true 启用左侧折叠控件;"autoCollapseOutput": false 是关键——目前 JupyterLab 官方并未实现该字段(设为 true 也无效),所以输出仍需手动折叠
  • 真正起作用的是 codeFolding:开启后,每个代码单元格左侧会出现蓝色竖条,点击即可折叠/展开

用 nbextensions 实现“运行即折叠输出”

这是最接近“自动折叠”的方案,依赖 jupyter_contrib_nbextensions 插件中的 Hide Input 或自定义 JS:

  • 安装插件:pip install jupyter_contrib_nbextensions && jupyter contrib nbextension install --user
  • 启用 Hide Input 扩展(它本质是折叠输入区+隐藏代码,非真正折叠)
  • 若要“运行后自动折叠输出”,需手动注入 JS:在 ~/.jupyter/custom/custom.js 中添加:
    define([
      'base/js/namespace',
      'base/js/events'
    ], function(Jupyter, events) {
      events.on('notebook:kernel-ready', function(){
        Jupyter.notebook.kernel.execute('from IPython.display import Javascript; Javascript("$(\'.output_subarea\').hide();")');
      });
    });
  • ⚠️ 注意:这段 JS 会在 kernel 启动后执行一次,不能保证每次 Shift+Enter 都触发;且折叠的是 DOM 元素,不是写入 .ipynb 文件的 collapsed 标记,刷新页面会失效

容易被忽略的关键点

折叠状态是否持久,取决于你改的是哪一层:

  • 点击三角图标 → 修改 cell.metadata.collapsed → 保存后下次打开仍保持折叠(✅ 真正持久)
  • 用 CSS display: none 隐藏输出 → 不写入文件 → 刷新即恢复(❌ 伪折叠)
  • JupyterLab 的 codeFolding 设置只影响 UI 控件是否出现,不影响默认折叠状态
  • nbextensions 中的 Collapsible Headings 折叠的是 Markdown 标题层级,对代码单元格无效

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
FrankenPHP集成Laravel详细教程
FrankenPHP集成Laravel详细教程

本专题提供FrankenPHP集成Laravel的详细配置指南,全面解析运行原理、开发环境搭建、Caddyfile配置、Octane工作模式、数据库连接、队列任务、定时任务和生产环境优化,解决部署过程中常见的报错与兼容性问题。

2026.10.08

0

20

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

2026.09.30

120

10

LLVM RISC-V参数配置教程
LLVM RISC-V参数配置教程

本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式,涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。

2026.09.30

100

14

LLVM IR中间表示入门指南
LLVM IR中间表示入门指南

本专题整理LLVM IR的核心概念,包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法,帮助新手理解LLVM编译流程中的关键层。

2026.09.30

80

12

PDF转图片方法
PDF转图片方法

需要把 PDF 页面用于上传、预览、分享或图片归档时,PDF 转图片方法专题整理 JPG/PNG 格式选择、逐页导出、清晰度设置、批量下载和结果检查等流程,帮助用户稳定完成 PDF 图片化处理。

2026.09.30

80

26

PixTV AI视频生成与无限画布创作
PixTV AI视频生成与无限画布创作

PixTV专题整理AI视频与视觉内容创作相关功能使用教程,涵盖AI生图、视频生成、无限画布、多模型创作、素材管理、声音音乐及视频剪辑等功能,帮助用户快速掌握PixTV从创意到成片的完整制作方法。

2026.09.29

100

15

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

2026.09.23

300

15

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

2026.09.23

180

15

Buffalo框架零基础入门教程
Buffalo框架零基础入门教程

本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。

2026.09.23

140

15

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程