VS Code添加多行注释时触发IndentationError缩进错误的问题

问题核心 #

报错指向函数文档字符串中的BlaBlaBla行存在IndentationError: unexpected indent——尽管你提供的两段代码视觉上一致，但实际本地文件中缩进字符（空格/制表符）存在不一致，或包含不可见的特殊空白字符。

排查与解决步骤 #

• 显示不可见空白字符：在VS Code中按Ctrl+Shift+P，输入Toggle Render Whitespace并执行，此时空格会显示为·，制表符显示为→。检查报错行BlaBlaBla的缩进，确认是否混用了空格和制表符，或存在多余缩进。
• 统一缩进配置：打开VS Code设置（Ctrl+,），搜索以下选项并设置：
  • Editor: Tab Size → 设置为4
  • Editor: Insert Spaces → 勾选（确保输入Tab时自动转换为空格）
• 修复现有代码：选中报错的BlaBlaBla行，删除现有缩进后重新输入4个空格；或直接使用VS Code的格式化快捷键Ctrl+Shift+I，自动统一整个文件的缩进。
• 排查复制粘贴问题：若代码来自外部复制，可能携带非标准空白字符。建议手动重新输入文档字符串部分，或用正则替换（查找[\t\s]+替换为4个空格）清理异常空白。

补充说明 #

你提供的代码在网页展示时可能被自动标准化了缩进，但本地无法运行的版本中，BlaBlaBla行的缩进不符合Python的统一规则（Python要求同一代码块内缩进完全一致），因此触发了缩进错误。

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