Go comment.Printer 的 TextCodePrefix 留空为什么仍有缩进

comment.Printer.TextCodePrefix 留空时，含义是使用默认值，而不是取消代码块前缀。默认代码前缀是 TextPrefix 再加一个制表符。如果 TextPrefix 也为空，代码行前仍会有一个制表符。设置非空 TextCodePrefix 时，它会替代普通文本前缀，而非叠加在 TextPrefix 后面。

官方地址：https://pkg.go.dev/go/doc/comment

可以把问题缩小为一个常见场景：文档导出器希望所有文字带同样的引用前缀，于是把 TextCodePrefix 清空，结果代码块比正文又多缩进一层。症状来自空字符串的默认语义，不需要先怀疑终端宽度或字体。这是用于讲解的场景，不是一份真实线上事故记录。

确认观察的是 Text 输出

TextCodePrefix 服务于 Printer.Text 生成的纯文本。HTML 或 Markdown 输出有各自的结构与表现规则，不能修改这个字段后直接期待网页代码块样式改变。先确认导出链路使用哪个方法，能避免在无关位置反复尝试。

纯文本里的制表符也不等于固定数量的空格。不同查看器的制表位设置可能让同样的字符显示成不同宽度。排查时应同时区分输出字符和查看器呈现，不要只凭肉眼看到的横向距离判断前缀是否生效。

解释空值回退与非空替代

TextPrefix 是普通文本行的前缀。代码块使用专门的 TextCodePrefix；若后者为空，Printer.Text 选择 TextPrefix 加制表符作为默认代码前缀。空字符串因此承担“未指定”的含义。

假设普通文本前缀为大于号与空格：默认代码行会在它之后增加制表符；如果明确把代码前缀设成竖线与空格，代码行使用竖线与空格，不会自动再加普通文本前缀。想同时保留普通前缀与额外空格，需要自己组合成完整的非空代码前缀。

比较三组 Printer 配置

下面直接构造 Doc 与 Code 对象，排除注释输入的公共缩进问题。三组 Printer 使用同一份文档，只有代码前缀配置不同。示例可以作为独立程序使用。

package main

import (
    "fmt"
    "go/doc/comment"
)

func main() {
    // 直接构造代码块，排除输入注释语法带来的额外因素。
    doc := &comment.Doc{Content: []comment.Block{
        &comment.Paragraph{Text: []comment.Text{comment.Plain("Example code:")}},
        &comment.Code{Text: "send(item)\n"},
    }}
    cases := []struct {
        name string
        printer comment.Printer
    }{
        {"default", comment.Printer{TextPrefix: "> "}},
        {"explicit", comment.Printer{TextPrefix: "> ", TextCodePrefix: "| "}},
        {"same-prefix", comment.Printer{TextPrefix: "> ", TextCodePrefix: "> "}},
    }
    for _, c := range cases {
        // 带引号输出让制表符可见；这不改变 Printer 的实际内容。
        fmt.Printf("%s: %q\n", c.name, c.printer.Text(doc))
    }
}

default 组的代码行包含普通前缀和制表符；explicit 组改为显式竖线前缀；same-prefix 组使用与正文相同的前缀。fmt 的带引号格式便于识别制表符、换行等字符，不代表 Printer 输出了反斜线字母组成的可见文本。这些是代码规则推导，不是本机执行日志。

当普通前缀非空、目标是保持代码和正文一致的外层标识时，第三组设置通常更直接。若两项都需要真正零前缀，单纯把两个字段都留空会触发默认缩进；这个字段没有另一个公开的“禁用默认值”布尔开关。

区分外层前缀与代码内容缩进

TextCodePrefix 控制代码行的外层前缀，代码内容本身的相对缩进仍然有意义。函数体、条件块等内部层级不能一并删掉。将整个导出文本逐行 TrimSpace，虽然可能消除外观上的缩进，也会破坏代码布局。

如果输入来自 Parser.Parse，应先确认输入已经移除注释标记；解析器对代码块的识别与规范化，与 Printer 的前缀设置属于不同职责。用于表示代码块的输入缩进，不应直接当成最终输出里所有前导空白的来源。

确实需要无外层缩进的纯文本导出时，可以基于 Doc 的块结构实现明确的输出规则，只在 Code 块层面处理前缀与内容。不要用一个占位空格伪装空前缀，更不要对整个结果盲目去除空白。

按目标格式安排输出

修复动作应从目标格式开始：网页展示选择 HTML 输出并处理页面样式；Markdown 文档使用对应输出；带引用标识的纯文本则为正文、代码分别设置完整前缀。配置文件也最好区分“使用默认”与“明确指定”，避免把空字符串展示成“无缩进”。

为避免类似问题反复出现，可在导出接口说明中写清空值语义、非空替代规则和内部缩进保留原则。排查时固定同一 Doc，只调整前缀，再观察字符层面的变化，通常比同时修改解析与渲染两端更容易判断。

TextCodePrefix 会与 TextPrefix 自动拼接吗？

非空时不会。它是代码行的替代前缀；只有为空触发默认时才采用普通前缀加制表符。

设置成一个空格是否等于无前缀？

不是，空格也是实际前缀。它可以覆盖默认值，但仍占一个字符位置。

为什么配置相同，两个查看器看起来缩进不同？

先区分制表符与空格，并检查查看器制表位设置。字符相同不保证视觉宽度相同。

参考：Printer 字段说明、纯文本打印实现。