如何解决Black格式化ipynb文件时的缩进错误及提交问题？

手动快速修复（适合小文件） #

• 打开research\evaluation_detection.ipynb，定位到第11行对应的代码单元格（用Jupyter Notebook或VS Code的Notebook插件可直接对应单元格内的行号）
• 检查该行缩进：统一使用4个空格（Python推荐风格），修正与外层不匹配的缩进层级，避免空格和制表符混用

自动化工具修复 #

1. 用nbqa + autopep8批量修复缩进 #

nbqa支持对Notebook单元格代码调用Python代码风格工具，autopep8专门擅长修复缩进类问题：

nbqa autopep8 --in-place research\evaluation_detection.ipynb

修复完成后再重新执行Black格式化：

black ".\research\evaluation_detection.ipynb"

2. 自定义Python脚本统一缩进 #

写个简单脚本遍历所有代码单元格，强制将缩进转为4个空格并修复层级：

import json

# 读取Notebook文件
with open("research\\evaluation_detection.ipynb", "r", encoding="utf-8") as f:
    nb_data = json.load(f)

# 处理每个代码单元格
for cell in nb_data["cells"]:
    if cell["cell_type"] == "code":
        fixed_source = []
        for line in cell["source"]:
            # 替换制表符为4个空格
            line = line.replace("\t", "    ")
            # 修复缩进层级：确保缩进是4的倍数
            stripped_line = line.lstrip()
            if stripped_line and not line.startswith(stripped_line):
                indent_count = len(line) - len(stripped_line)
                corrected_indent = "    " * (indent_count // 4)
                fixed_source.append(corrected_indent + stripped_line)
            else:
                fixed_source.append(line)
        cell["source"] = fixed_source

# 保存修复后的文件
with open("research\\evaluation_detection.ipynb", "w", encoding="utf-8") as f:
    json.dump(nb_data, f, indent=2)

运行脚本后再尝试Black格式化即可。

3. 临时用yapf替代格式化 #

如果Black仍无法处理，可先用yapf临时格式化Notebook，后续再切换回Black：

nbqa yapf --in-place research\evaluation_detection.ipynb

预防后续问题 #

• 配置编辑器（VS Code/Jupyter）默认使用4个空格缩进，禁用制表符输入
• 提交前用nbqa flake8提前检测代码风格问题：

nbqa flake8 research\evaluation_detection.ipynb

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