1. 搞懂Jupyter的快捷键底子：两种模式才是核心

1.1 为什么快捷键要分成“编辑模式”和“命令模式”

用Jupyter的人一听到快捷键，第一反应往往是“背不下来”。实际上，Jupyter的快捷键体系并不像Word那样追求“全盘覆盖”，它围绕一个非常核心的概念来构建：单元格（Cell）。整个Notebook本质是一长串单元格的列表，每个单元格要么是代码，要么是Markdown。快捷键输入之前，系统必须先知道焦点在哪个区域、要处理的是文本内容还是单元格结构本身。这就是“两种模式”存在的根本原因。

按下Enter，光标进入当前单元格，这叫作编辑模式（Edit Mode），此时按键应当被当成文本输入，比如按下A，就在代码里打出一个字母A。按下Esc，焦点退出单元格，进入命令模式（Command Mode），此时按键被当成操作指令，比如按下A表示“在当前单元格上方插入一个新单元格”，按下B表示“在下方插入”。这套设计思路和Vim的Insert与Normal模式非常像，本质上都是为了解决同一个矛盾：键盘既要用来打字，又要用来发指令，必须靠模式切换来区分意图。

理解这个设计后，很多困扰自然就解开了。比如有人发现在单元格里按B没有任何反应，以为是快捷键坏了，其实只是模式不对。同样的按键，在不同模式下含义完全不一样，这是Jupyter快捷键的第一原则，也是后续自定义快捷键之前必须先搞明白的前提。

1.2 默认快捷键里最值得记住的几组

很多人的一个误区是：一上来就想自定义快捷键，结果默认基础键都没用熟。我建议你先花两周把下面这些默认快捷键练到肌肉记忆，再谈自定义，效率提升远比配一堆花哨键位来得快。

命令模式下最核心的操作：

• A / B：在当前单元格上方/下方插入新单元格，这是Notebook里最高频的动作
• DD：连续按两次D，删除当前单元格，删除后可以通过Z撤销
• M / Y：把当前单元格切换为Markdown / 代码
• Shift+Enter：运行当前单元格并选中下一个单元格，这是日常写代码最常用的键
• Ctrl+Enter：运行当前单元格但不移动光标
• Alt+Enter：运行当前单元格并在下方插入一个新单元格
• C / X / V：复制、剪切、粘贴单元格（注意是在命令模式下，不是编辑模式）
• 0 + 0：连续按两次0，重启内核
• Z：撤销单元格删除

编辑模式下值得记住的：

• Tab：代码补全，写Python时几乎离不开
• Shift+Tab：查看函数文档或签名，这个很多人不知道，查API特别好用
• Ctrl+Shift+-：横线减号，拆分当前单元格，把长代码块一分为二
• Esc：退回命令模式

我把这些快捷键整理成表，方便对照记忆：

这几组键练熟之后，你的手基本可以不用离开键盘完成80%的笔记本操作。

1.3 不同环境下的默认差异：Notebook与JupyterLab不是一回事

需要特别提醒：经典Jupyter Notebook和JupyterLab的快捷键体系并不完全一样。经典Notebook（6.x及以前）使用的是老式快捷键系统，通过custom.js来扩展；JupyterLab 3.x之后则完全是另一套基于命令系统的快捷键框架，配置方式和底层机制都不同。VSCode里通过插件使用Jupyter的话，走的又是VSCode自己的快捷键规则。

这意味着，你在网上搜到一份快捷键配置教程时，先看它针对的是哪个环境。直接照搬到另一个环境，轻则无效，重则报错。我在本文里会把手动区分开讲，尽量避免踩混。

2. 在经典Jupyter Notebook里添加自定义快捷键

2.1 不写代码的图形界面方式

经典Notebook其实内置了一个可视化快捷键编辑面板，位置在菜单栏：Help → Edit Keyboard Shortcuts。点击后会弹出一个窗口，里面列出了所有默认快捷键，每一项都可以修改绑定。操作方式很直观：先点击某个操作右侧的输入框，然后直接按下你想绑定的组合键，比如按下Ctrl+Shift+J，系统会识别并写入这个键位，点一下Assignment确认，关闭弹窗后刷新页面生效。

这个方式很适合初学，不需要碰配置文件，所见即所得。但它有一个很隐蔽的坑：这份配置是存在浏览器本地存储（localStorage）里的，不是保存在服务器端。换句话说，你在Chrome里配置好的快捷键，换到Firefox、换台电脑、或者开了隐身模式，全部消失。对我这种长期在多个环境里切换的人来说，它只能当作临时方案，不能作为正式配置来用。

另外还有个小细节：菜单栏里的“Edit Keyboard Shortcuts”弹窗，某些老版本Notebook里只能查看和修改已有绑定，并不能添加“新的”操作项。如果你想让某个未暴露的操作触发快捷键，比如“清空所有单元格输出”，图形界面就无能为力了，必须走下面的文件方式。

2.2 一劳永逸的custom.js配置法

要让配置真正持久、并且能写入任意操作，标准做法是修改custom.js文件。这是Notebook启动时自动加载的JavaScript，位于Jupyter配置目录下的custom子目录中。

先找到配置文件目录。命令行中执行：

jupyter --paths

输出结果里会列出config路径，通常是：

• Linux/macOS：~/.jupyter/
• Windows：C:\Users\<用户名>\.jupyter\

在这个目录下，如果还没有custom子目录，先手动创建：

mkdir -p ~/.jupyter/custom

然后编辑（或创建）~/.jupyter/custom/custom.js。custom.js使用RequireJS风格来加载模块，一个最基础的添加快捷键的写法如下：

define([ 'base/js/namespace', 'jquery' ], function(Jupyter, $) { // 注册一个新的命令模式快捷键：Ctrl+Shift+X Jupyter.keyboard_manager.command_shortcuts.add_shortcut('Ctrl-Shift-X', { help: '这是我自定义的快捷键示例', help_index: 'zz', handler: function(event) { console.log('快捷键被触发'); return false; // 阻止浏览器默认行为 } }); });

我来逐段解释这段代码做了什么。开头的define是RequireJS的模块定义语法，第一行声明依赖base/js/namespace和jquery，前者是Jupyter对象本身，后者是处理DOM的工具库。接下来调用Jupyter.keyboard_manager.command_shortcuts.add_shortcut来注册一个命令模式下的快捷键。

add_shortcut的第一个参数是组合键名称，格式是Ctrl-Shift-X这种用连字符连接的写法。第二个参数是配置对象，其中handler是真正执行动作的函数。这里务必注意：handler里需要对通过Jupyter对象触发的操作做包装，不能直接在全局作用域里写死DOM操作，否则无法保证与Notebook内部状态的同步。

return false这行非常关键。它表示事件已经被处理，丢弃默认行为。如果漏写，浏览器可能继续往下执行，某些组合键会被浏览器或页面本身消费掉，造成快捷键失灵或产生奇怪的副作用。

如果想添加编辑模式下的快捷键，把command_shortcuts换成edit_shortcuts即可：

Jupyter.keyboard_manager.edit_shortcuts.add_shortcut('Ctrl-Shift-Y', { handler: function(event) { // 在编辑模式下执行自定义动作 return false; } });

编辑模式下的快捷键通常需要带修饰键（Ctrl、Alt、Shift），因为编辑模式下字母键会被当作文本内容。

2.3 踩过的坑：为什么我的custom.js没生效

custom.js不生效是高频问题，我总结几个真实经历过的原因：

第一，文件名或路径不对。有些教程说应该放在~/.jupyter/custom/，有些说~/.jupyter/下，还有版本之间路径有差异。稳妥做法是执行jupyter --paths，看输出的config路径，然后custom目录务必建在第一个config路径下面。文件名必须是custom.js，少写后缀或改成别的名字都不会加载。

第二，浏览器缓存。这个是最隐蔽的坑。custom.js是页面加载时读取的，但浏览器对js文件有缓存。你改了文件内容，刷新页面时可能加载的还是旧版本。解决方法是强制刷新（Ctrl+Shift+R或者Cmd+Shift+R），或者直接在开发者工具里Disable cache后再刷新。

第三，整个文件因为一个小错误崩溃。custom.js是单个文件执行的，如果顶部有语法错误，整个文件都不会执行，所有自定义快捷键都会失效。排查方法很简单：打开浏览器开发者工具（F12），切到Console面板，看有没有红色报错。如果有报错，通常能直接定位到custom.js第几行。

第四，大小写和格式问题。快捷键名称里的分隔符，必须是英文连字符，不能用下划线，写法和官方API要求完全一致。

第五，混用了编辑器模式配置。比如你想让Ctrl+H在单元格内部也能生效，却把它加到了command_shortcuts里，那在编辑模式下按了自然没反应。要区分清楚当前快捷键应该在哪种模式下生效。

3. JupyterLab版本的自定义快捷键：更现代的框架

3.1 界面操作：两三分钟搞定一个自定义快捷键

JupyterLab对快捷键的支持比经典Notebook成熟得多。最友好的入口是菜单栏：Settings → Keyboard Shortcuts。打开后会看到一个完整的快捷键管理界面，顶部有搜索框，能按操作名称搜，也能按绑定的按键搜。

添加步骤很直观。在搜索框里输入你想绑定的操作，比如输入“clear”会过滤出所有和清除相关的命令。找到你想要的命令后，点击它右侧的“+”号，会出现一个输入框。这时直接按下你想绑定的组合键，比如按下Ctrl+Alt+K，JupyterLab会弹出一个小窗口，提示这个组合键当前是否已被占用，以及是否绑定到其他命令。确认无误后回车，快捷键就生效了，它会被自动写入用户设置。

如果按键已经被其他命令占用，界面会标红提示冲突，这时你有两个选择：取消绑定，或者强行覆盖。覆盖意味着原来的绑定被替代，不再生效。做覆盖前建议想清楚，别把某个核心命令的快捷键抢走了却不自知。

3.2 直接改settings.json：可复制、可迁移的正式做法

图形界面的操作最终也会落到配置文件里，但更适合正式使用的，是直接编辑用户设置JSON。所有通过界面配置的快捷键，最终都保存在用户设置文件中，路径一般是：

• Linux/macOS：~/.jupyter/lab/user-settings/
• Windows：C:\Users\<用户名>\.jupyter\lab\user-settings\

你可以在JupyterLab里打开Settings → Settings Editor，左侧选择Keyboard Shortcuts，然后点击右侧的高亮文字进入JSON编辑器模式，在这里写入自己的快捷键配置。

一个完整的自定义快捷键JSON文件长这样：

{ "shortcuts": [ { "command": "notebook:run-cell-and-select-next", "keys": ["Accel Shift Enter"], "selector": "[data-jp-kernel-user]" }, { "command": "notebook:clear-cell-output", "keys": ["Accel Shift K"], "selector": "[data-jp-kernel-user]" } ] }

这段配置的含义是：第一项，为运行单元格命令添加Accel Shift Enter组合键；第二项，为清除当前单元格输出添加Accel Shift K组合键。

Accel是一个特殊的占位符，它会在不同操作系统上自动替换成对应的修饰键。在Windows和Linux上，Accel代表Ctrl键；在macOS上，它代表Cmd键。用Accel写配置的好处是：同一份JSON在Mac和Windows上都能正常工作，不会因为系统差异而失效。

selector字段决定快捷键的作用范围。JupyterLab是一个多组件应用，同一时间可能打开着笔记本、文本编辑器、文件浏览器等多种面板，快捷键不能无条件全局生效。[data-jp-kernel-user]这个选择器表示只在笔记本有内核交互的单元格区域生效；如果绑定了文件编辑命令，selector要改成对应编辑器的选择器。

这个文件是支持版本管理的，可以提交到Git里随身携带。换了一台新机器，克隆配置后放到同样的目录就能无缝还原，这一点比经典Notebook的localStorage方案强太多。

3.3 怎么找到想要的命令ID

自定义快捷键前，最大的障碍是：我不知道这个操作的命令ID叫什么。

最简单的方法：在Settings → Keyboard Shortcuts界面，用搜索框输入能想到的功能词，比如“run”、“clear”、“insert”，结果列表里每一行最右侧就有命令ID，比如notebook:run-cell-and-select-next。把它抄下来，填进JSON的command字段。

还有一个进阶方法，在开发者工具Console里执行：

jupyterapp.commands.list()

这个命令会列出当前环境中所有已注册的命令ID，配合filter可以进行模糊搜索：

jupyterapp.commands.list().filter(c => c.includes('clear'))

就会输出所有和clear相关的命令ID，非常方便。

常见命令ID我整理了一下：

需要注意的是，不同版本之间命令ID可能有细微变化。比如JupyterLab 3.x和4.x，某些notebook命令的前缀从jupyter-notebook:变成notebook:，升级时配置可能失效。遇到这种情况，就用命令面板或者jupyterapp.commands.list()重新查一遍。

4. 三个高频自定义快捷键实操案例

4.1 案例一：给Notebook添加“运行所有单元格并保存”

场景是这样的：一次数据清洗跑完，我想立刻确认整个流程能不能完整跑通，默认操作是点击Cell菜单里的Run All，再手动Ctrl+S保存。次数多了就烦，干脆配一个快捷键。

先处理经典Notebook，在custom.js中写入：

define([ 'base/js/namespace' ], function(Jupyter) { Jupyter.keyboard_manager.command_shortcuts.add_shortcut('Ctrl-Shift-R', { help: '运行所有单元格并保存', help_index: 'zz', handler: function(event) { Jupyter.notebook.run_all(); Jupyter.actions.call('notebook:save-notebook'); return false; } }); });

这里有个容易忽略的细节：Jupyter.notebook.run_all()在后台跑完后并不会自动保存文件，需要再显式调用保存动作。顺序上，先运行后保存，配合return false保证浏览器不插队。

再说JupyterLab版本。直接写settings.json里的配置：

{ "shortcuts": [ { "command": "notebook:run-all-cells", "keys": ["Accel Shift R"], "selector": "[data-jp-kernel-user]" }, { "command": "notebook:save-notebook", "keys": ["Accel Shift S"], "selector": "[data-jp-kernel-user]" } ] }

我习惯把运行所有和保存拆成两个快捷键，因为有些场景只想运行、不想保存，拆开更灵活。

这里提醒一个点：Accel Shift R在Chrome里默认是“重新加载页面”的快捷键吗？不是，Chrome默认是Ctrl+Shift+R。但Accel Shift R在macOS下是Cmd+Shift+R，Chrome里也是强制刷新。所以要小心，macOS用户不要把这个组合绑到运行所有上，否则按下去浏览器直接刷新，配置白搭。经过实测，更稳妥的方式是把运行所有绑到Accel Alt R或者Accel Shift F9一类比较冷门的组合上。

4.2 案例二：在JupyterLab里绑定“清空当前单元格输出”

做数据分析和调试时，我经常要清空某个块的输出来看干净结果，鼠标右键选择“Clear Output”来回跑了无数次。绑定快捷键后效率提升非常明显。

在图形界面的操作是：Settings → Keyboard Shortcuts → 搜索“clear cell output” → 点击notebook:clear-cell-output行尾的“+”号 → 弹窗里按下Ctrl+Alt+K（注意自己按下的组合键会直接出现在输入框里，不要手动打字敲快捷键）→ 回车确认。

设置好后，每次按Ctrl+Alt+K，当前选中单元格的输出区就被清空。

有时我想清空整个笔记本的输出，那就要找notebook:clear-all-cell-outputs这个命令，绑定方式一模一样。但凡是涉及“全部”的命令，我建议确认一下scope是否出问题：比如光标在一个单元格里，按快捷键是整个笔记本生效还是只作用一个格子。实测下来，JupyterLab中clear-all-cell-outputs是全局的，不受光标位置影响，放心用。

4.3 案例三：把“插入上方单元格”换到自己顺手的键位

默认的A键确实好用，但在某些场景下，我想用带修饰键的组合，避免手从Home Row移开太远。JupyterLab里，把notebook:insert-cell-above绑定到Ctrl+Shift+A：

{ "shortcuts": [ { "command": "notebook:insert-cell-above", "keys": ["Ctrl Shift A"], "selector": "[data-jp-kernel-user]" } ] }

这里特意写了Ctrl Shift A而不是Accel Shift A，我是故意的。如果写Accel，Mac上会被替换为Cmd，但我希望无论哪个平台都保持同样的键位，那么直接写死Ctrl Shift A更符合预期。这类跨平台一致性需求，建议明确写死而非用Accel。

配置完成后，如果你在快捷键管理界面看到这个命令同时背着两把钥匙——一个是系统默认的A键，一个是自定义的Ctrl+Shift+A——这是正常现象，JupyterLab允许一个命令有多个快捷键绑定，互不冲突。

4.4 配置管理经验：让快捷键配置跟着你走

配置这东西最怕重装环境后满地找牙。我个人的做法是创建一个jupyter-config目录，里面放两个文件：一个用于经典Notebook的custom.js，一个用于JupyterLab的shortcuts.json（即上面的settings.json内容）。这两个文件纳入Git仓库管理，每次改完配置就在仓库里提交一次。换新环境时，clone仓库，把文件复制到对应路径就行。

经典Notebook的路径是：~/.jupyter/custom/custom.js。JupyterLab的路径更复杂，不同版本位置略有差异，如果找不到，在Settings Editor里能看到当前用户设置的实际存放路径。

还有一个技巧：如果团队共用一套Jupyter服务器，可以通过环境变量JUPYTER_CONFIG_DIR指定配置目录，把整个配置目录放到共享存储上，这样所有人加载同一份配置。当然，前提是大家使用的Jupyter版本一致，否则可能引发兼容性问题。

5. 常见问题排查实录

5.1 快捷键按下没反应？按这个顺序排查

排第一的永远是模式问题。编辑模式下按字母或简单组合键，系统会优先当成文本输出，这是设计使然。如果你确认按下了Esc后再执行快捷键仍无效果，再往下查。

5.2 配置对不上、重启后失效怎么办

经典Notebook的localStorage配置方向问题很大。你可能配置好一周后，突然失效，原因很可能是不小心清除了浏览器站点数据，或者浏览器自动清理了localStorage。这种方案本身就不够稳固，所以我平时主要用custom.js来配经典Notebook，让配置落在服务器端。

JupyterLab的settings配置也存在用户目录里的，正常不会丢失。但有一种坑：如果你同时打开了多个标签页，在其中一个标签页修改配置后，另一个标签页可能还是旧配置。JupyterLab配置文件是实时读取的，但某些内部组件并不会主动监听变化。遇到这种情况，刷新所有标签页即可。

5.3 想删除或覆盖默认快捷键

覆盖默认快捷键在JupyterLab里有一个“remove”技巧。假设你觉得默认的Shift+Enter运行单元格不够顺手，想改为Ctrl+Enter（但保留默认），可以直接在配置里添加。但如果想彻底移除某一项默认绑定，需要用remove字段：

{ "shortcuts": [ { "command": "notebook:run-cell-and-select-next", "keys": ["Accel Enter"], "selector": "[data-jp-kernel-user]" }, { "remove": "notebook:run-cell-and-select-next", "keys": ["Shift Enter"], "selector": "[data-jp-kernel-user]" } ] }

注意remove的写法：它不是一个独立命令，而是和命令配对出现的。含义是：先删除这个命令在当前selector下绑定的Shift Enter，再新增Accel Enter。最终效果是把这个快捷键从Shift+Enter改成Ctrl+Enter（Mac上则是Cmd+Enter）。

经典Notebook删除快捷键用的是remove_shortcut：

Jupyter.keyboard_manager.command_shortcuts.remove_shortcut('Ctrl-Shift-X');

这样就能把之前绑定的快捷键解绑。注意：remove_shortcut只删除自定义绑定，不能删除系统内置的默认快捷键。试图删除系统快捷键在经典Notebook里是做不到的。

5.4 版本升级后快捷键失效

这个坑我真的踩过好几次。JupyterLab 3.x升级到4.x时，部分命令ID发生了变更。比如原来用jupyter-notebook:run-cell，在新版本里可能变成了notebook:run-cell。如果你一早用命令面板搜索到的新ID，在升级后就失效了。

应对方法只有一个：升级之后，打开快捷键管理界面，搜索你常用的功能名，看列表里显示的ID和你配置里的ID是否一致。如果不一致，更新配置即可。为了避免来回折腾，我反而不太建议在升级大版本后立刻改快捷键配置，等新环境稳定两天，再一次性把配置调好。

另外，经典Notebook从6.x到7.x，快捷键底层的改动比较大。如果你还依赖custom.js的一些老API，升级后可能整体加载失败。我在测试环境里遇到过define is not defined这类报错，就是因为新版Notebook不再使用RequireJS加载custom.js。遇到这种版本断层，最好直接迁移到JupyterLab，而不是在老方案上死磕。

6. 让快捷键配置真正融入日常工作

6.1 维护一份自己的键位地图

配置快捷键最忌讳贪多。我见过有人把二十多个操作都绑上快捷键，最后自己都记不住，鼠标又切回去了。实用的做法是按使用频率划分层级，只给真正高频的操作配置键位。

我自己的键位规划是这样：

• 运行组：Shift+Enter（运行并下移）、Alt+Enter（运行并插入）、Ctrl+Enter（运行不移动）
• 结构组：A/B（上下插入）、DD（删除）、Ctrl+Shift+A（我自定义的上方插入）
• 输出组：Ctrl+Alt+K（清除当前输出）、Ctrl+Shift+O（清除所有输出，自定义）
• 状态组：00（重启内核）、M/Y（切换Markdown/代码）

这组的底层逻辑是：运行是最高频操作，必须最顺手；结构操作用默认键就行；输出清理是调试时的高频动作，配自定义键很划算；状态切换用默认键别乱动。

6.2 从快捷键到工作流升级

快捷键真正的价值，不在于省下几秒，而在于打断了“手在键盘和鼠标之间来回切换”的节奏。调试代码时，思路正集中在“这一行改完跑一下看看结果”的循环里，每一次从键盘移到鼠标再移回来，都是一次微小的注意力损失。把高频操作绑到快捷键后，这个循环变成纯键盘驱动，注意力损耗大幅下降。

数据探索场景下典型的操作流是：读入数据 → 看shape和信息 → 跑一段清洗 → 看输出 → 画个图。对应快捷键就是：Shift+Enter跑，Ctrl+Alt+K清输出，B插新格，M切Markdown记笔记。整套流程下来手几乎不离开键盘，鼠标只在拖拽选择代码片段时才会碰。

我实测下来，这个流程适应两周后，处理同样规模的表格数据，整体操作时间大约能省下两到三成。这个数字不算夸张，因为省掉的不是计算时间，而是操作摩擦。

6.3 不同环境记住各一套配置

最后说个容易被忽略的点：Jupyter Notebook和JupyterLab的快捷键不要强行保持一致。经典Notebook的编辑模式快捷键体系与JupyterLab差异不小，强行统一反而两边都是半吊子。我个人的选择是：分析型工作尽量用JupyterLab，老项目维护时用到经典Notebook，两套快捷键各自成体系，互不干扰。

配置这东西没有“标准答案”，只有适合不适合。一开始多抄人家的配置很正常，但最终一定要形成自己高频肌肉记忆的那一套。别急着一次性配完，用三五天，觉得哪个操作不顺就改一个，慢慢调整出来的键位才是真正好用的。

我自己是在踩过多次“快捷键没生效”“升级后配置挂掉”的坑之后，才逐渐稳定下来这套方案。现在每次重装环境，十分钟就能把配置恢复到位，比手忙脚乱一边翻教程一边试要省心太多。