如何裁剪引入的源代码片段开头的缩进空白字符？

所有方案的核心逻辑统一为：先过滤全空白行，统计所有非空行的前导空白字符最小长度，再逐行删除对应长度的前导空白即可，以下是不同开发场景的具体实现方案：

1. 原生语言工具实现 #

Python 场景 #

标准库自带开箱即用的能力，无需自行实现逻辑：

import textwrap

# 引入的外部带缩进代码片段
external_code = """
    def get_user_info(user_id):
        if not user_id:
            return None
        return db.query(user_id)
"""
# 直接调用方法即可完成缩进裁剪
processed_code = textwrap.dedent(external_code)

JavaScript/TypeScript 场景 #

可以自行实现轻量工具函数，也可以直接使用社区成熟的 dedent 三方包：

function dedent(codeStr) {
  const lines = codeStr.split('\n')
  // 计算所有非空行的最小前导缩进长度
  const minIndent = Math.min(
    ...lines
      .filter(line => line.trim() !== '')
      .map(line => line.match(/^\s*/)[0].length)
  )
  // 逐行裁剪对应长度的前导空白
  return lines.map(line => line.slice(minIndent)).join('\n')
}

2. 文档/静态站点生成场景 #

如果是在内容生产流程中引入外部代码片段，大部分主流工具都内置了对应的配置开关：

• VitePress/VuePress：引入代码片段时添加 :dedent 修饰符即可自动裁剪前导缩进
• Docusaurus：可全局开启 codeBlock.dedent 配置，也可针对单个代码片段指定裁剪长度
• MkDocs：安装 mkdocs-material 扩展后，在代码块配置项中添加 dedent 参数即可生效

3. 命令行批量处理场景 #

需要批量处理多文件的代码片段缩进时，可以直接用 awk 单行命令实现：

# 替换目标文件路径即可完成批量裁剪
awk 'NR == FNR { if ($0 != "") { match($0, /^ */); len = RLENGTH; if (len < min || min == "") min = len } next } { print substr($0, min + 1) }' target_code.js target_code.js

边界情况处理建议 #

• 遇到制表符、空格混合的缩进：先统一把制表符替换为对应长度的空格（通常为4个）再计算最小缩进，避免长度计算错误
• 首尾存在多余空行：可以在裁剪缩进前后额外调用 trim()/strip() 方法清理首尾空白
• 需保留特定行的缩进：计算最小缩进前提前过滤掉带特殊标记的行，或者单独指定全局裁剪长度即可

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