Go strconv.IsPrint 判断字符是否适合可打印日志的方案

先给结论：strconv.IsPrint(r) 适合做日志输入的单字符门禁。它接收一个 rune，对字母、数字、标点、符号和 ASCII 空格返回 true，对制表符、换行、回车和 NUL 等控制字符返回 false。如果要处理字符串，应使用 range 或 strings.Map 按 rune 遍历，不能把中文拆成 byte 后逐字节判断。

先把 IsPrint 的判断边界划清

这类需求最容易混淆两个概念：字符能否显示，和字符是否符合当前日志格式。strconv.IsPrint 与 unicode.IsPrint 的判断口径一致，面向单个 rune；ASCII 空格是一个例外中的常见成员，它可打印，但制表符并不是可打印字符。

因此，标题中的“适合可打印日志”不是说所有输入都必须被无条件保留，而是先得到稳定的字符分类，再由日志格式选择处理结果。

按 rune 过滤日志里的控制字符

如果策略是“只保留可打印字符”，可以让 strings.Map 完成过滤。回调返回 -1 表示删除当前 rune；它不会破坏 UTF-8 中文、表情或其他多字节字符。

package logguard

import (
    "strconv"
    "strings"
)

func printableLogText(input string) string {
    // 先按 rune 遍历，避免把 UTF-8 中文拆成单字节。
    return strings.Map(func(r rune) rune {
        // IsPrint 只判断当前字符，删除控制字符交给这一层策略。
        if !strconv.IsPrint(r) {
            return -1
        }
        return r
    }, input)
}

func allPrintable(input string) bool {
    for _, r := range input {
        // 发现一个不可打印字符就拒绝整条字段。
        if !strconv.IsPrint(r) {
            return false
        }
    }
    return true
}

两种函数的语义不同：printableLogText 是“修剪后继续写日志”，适合非关键诊断字段；allPrintable 是“发现边界字符就拒绝”，适合协议标签、审计字段或要求单行的结构化值。不要在底层工具函数里偷偷选择业务策略。

把判断放到流水线门禁，而不是冒充脱敏

更稳妥的组织方式是把输入编码、字符可打印性和输出格式拆开。先验证字符串是否为合法 UTF-8；再按 rune 运行 IsPrint；最后根据字段类型选择删除、替换为空格，或直接返回错误。

图：IsPrint 的输入类型、判断口径与日志策略边界

package logguard

import (
    "fmt"
    "strconv"
    "strings"
    "unicode/utf8"
)

func prepareSingleLine(input string) (string, error) {
    // 先拒绝非法 UTF-8，避免错误字节被 range 转成替代 rune 后混入日志。
    if !utf8.ValidString(input) {
        return "", fmt.Errorf("invalid UTF-8 log field")
    }

    var b strings.Builder
    // 预留原始字节容量，减少常见短字段的扩容次数。
    b.Grow(len(input))
    for _, r := range input {
        // 单行字段不保留控制字符；是否替换为空格由上层另行决定。
        if strconv.IsPrint(r) {
            b.WriteRune(r)
        }
    }
    return b.String(), nil
}

这段代码仍然只是字符过滤，不是日志脱敏。手机号、令牌、邮箱等敏感字段即使全部可打印，也不应该原样写入日志；它们需要独立的字段级脱敏规则。相反，如果日志本来需要换行或制表符，就应该为多行格式定义显式白名单，而不是简单套用 IsPrint。

图：UTF-8 校验、rune 门禁和日志输出策略的职责分界

上线前检查这几个边界

简短问答

IsPrint 能判断整个字符串吗？

不能。它只接收一个 rune；字符串需要通过 range、strings.Map 或循环逐个判断。

为什么不能按 byte 判断中文？

UTF-8 中文通常由多个字节组成，逐 byte 判断会把一个字符拆散。按 rune 遍历才能保持字符边界。

过滤控制字符后就安全吗？

不安全。过滤只解决可打印性和日志格式问题，敏感信息隐藏、编码校验、长度限制和结构化字段约束仍需单独处理。

官方定义可参考 strconv.IsPrint；实现时把它定位为“字符门禁”，再由业务代码明确输出策略，边界会更容易测试和维护。