如何在VSCode中为Jupyter Notebook配置Black自动保存格式化？

首先明确：Black Formatter（ms-python.black-formatter）目前不支持直接配置.ipynb文件保存时自动格式化所有代码单元格，但可以通过以下几种方案实现需求：

方案一：配置VS Code原生Notebook格式化设置 #

确保VS Code版本在1.70+且Black Formatter为最新版，在settings.json中添加以下配置，利用VS Code的Notebook格式化触发机制结合Black：

"notebook.formatOnSave.enabled": true,
"[python]": {
  "editor.defaultFormatter": "ms-python.black-formatter",
  "editor.formatOnSave": true
},
"notebook.defaultFormatter": "ms-python.black-formatter"

该配置会在保存Notebook时自动调用Black格式化所有代码单元格，保持和.py文件一致的体验。

方案二：使用专门的Notebook格式化扩展 #

若原生配置不生效，可安装Notebook Formatter扩展，它支持绑定Black作为格式化引擎并配置保存自动格式化：

1. 安装扩展后，在settings.json中添加：

"notebookFormatter.formatOnSave": true,
"notebookFormatter.formatter": "black"

2. 确保本地已通过pip install black安装Black，扩展会调用本地Black完成单元格格式化。

方案三：自定义快捷键+宏（临时替代方案） #

不想安装新扩展的话，可通过VS Code宏功能实现一键格式化所有单元格并绑定到保存快捷键：

1. 安装multi-command扩展
2. 在settings.json中添加宏配置：

"multiCommand.commands": [
  {
    "command": "multiCommand.formatAllNotebookCells",
    "sequence": [
      "notebook.selectAllCells",
      "editor.action.formatDocument",
      "notebook.clearSelection"
    ]
  }
]

3. 在keybindings.json中绑定到Ctrl+S：

{
  "key": "ctrl+s",
  "command": "multiCommand.formatAllNotebookCells",
  "when": "editorLangId == 'python' && notebookEditorFocused"
}

按下Ctrl+S时，会自动选中所有单元格、执行格式化、取消选中，模拟自动格式化效果。

内容的提问来源于stack exchange，提问作者Ellie Su