str_pad按字节填充，不支持多字节字符安全对齐；处理中文等需用mb_strlen+mb_substr手动实现，否则会导致截断或错位。
str_pad 会把字符串补成固定长度，但默认只支持 ASCII 字符
str_pad 的核心作用是让字符串达到指定长度，不足部分用指定字符填充。它不改变原字符串，而是返回新字符串。关键限制在于：如果原字符串含多字节字符（比如中文、emoji），str_pad 按字节计数，不是按字符计数 —— 这会导致中文被截断或填充错位。
常见错误现象：
- 对 "你好" 调用 str_pad("你好", 10, "0")，结果不是你预期的 10 个“字符”宽，而是按 UTF-8 字节算（"你好" 占 6 字节），最终可能补出 4 个 "0"，总长 10 字节，但视觉上远不到 10 个汉字宽度。
- 在终端或等宽字体下对齐失败，尤其用于日志、表格输出时明显错位。
- 使用场景：生成固定宽度的日志前缀、数据库字段补零、ASCII 表格对齐、文件名编号对齐
- 三个必需参数：
str_pad(<code>$input,$length,$pad_string,$pad_type) -
$pad_type只能是STR_PAD_LEFT、STR_PAD_RIGHT（默认）、STR_PAD_BOTH -
$pad_string长度至少为 1 字节；若超过 1 字节（如"--"），会被循环截断使用
中文/UTF-8 字符串必须先转字节数为字符数，再手动 pad
PHP 原生 str_pad 不支持多字节安全模式。要真正按“字符数”补全，得用 mb_strlen + mb_substr 手动实现逻辑。
示例：按 10 个汉字宽度右对齐补空格（视觉对齐）：
function mb_str_pad($str, $length, $pad_str = ' ', $pad_type = STR_PAD_RIGHT) {
$str_len = mb_strlen($str, 'UTF-8');
if ($str_len >= $length) return $str;
$pad_len = $length - $str_len;
$pad_str = str_repeat($pad_str, ceil($pad_len / mb_strlen($pad_str, 'UTF-8')));
$pad_str = mb_substr($pad_str, 0, $pad_len, 'UTF-8');
return $pad_type === STR_PAD_LEFT
? $pad_str . $str
: ($pad_type === STR_PAD_BOTH
? str_repeat(' ', (int)(($pad_len - mb_strlen($pad_str, 'UTF-8')) / 2)) . $str . str_repeat(' ', (int)(($pad_len + 1) / 2))
: $str . $pad_str);
}注意：STR_PAD_BOTH 在多字节下没有标准对齐语义，上面示例只是近似；实际项目中建议避免用 STR_PAD_BOTH 处理中文，改用明确的左/右对齐 + 手动空格控制。
立即学习“PHP免费学习笔记（深入）”；
性能差异：str_pad 比 mb_* 系列快 3–5 倍，但仅限纯 ASCII 场景
在处理大量日志行号、数字 ID、英文字段时，原生 str_pad 是最优选择。一旦混入中文、日文或 emoji，强制用它会导致不可控的字节偏移 —— 此时性能优势毫无意义，反而引入数据错位 bug。
- 纯数字补零（如订单号
"ORD000123"）：直接用str_pad($id, 9, "0", STR_PAD_LEFT) - 用户昵称对齐（含中文）：必须用
mb_*手写逻辑，或改用 sprintf + 宽度占位（仅限固定字体环境） - CLI 输出表格：推荐用
printf("%-10s %-20s", $name, $email)，比反复调用str_pad更轻量且可控
容易被忽略的边界：$pad_string 为空或 null 会触发警告
str_pad 要求第三个参数 $pad_string 不能为空字符串或 null，否则抛出 Warning: str_pad(): Padding string cannot be empty。这个检查发生在运行时，IDE 和静态分析通常无法提前捕获。
- 别写
str_pad($x, 10, "")—— 即使你本意是“不填充”，也得显式判断：strlen($x) - 从配置读取
$pad_char时，务必用trim()并校验：if (!$pad_char = trim($config['pad_char'])) $pad_char = " " -
$length小于等于原字符串长度时，str_pad直接返回原字符串，不会截断 —— 截断得靠substr或mb_substr
多字节字符串的 padding 本质是显示层问题，不是字符串操作问题。别指望一个底层字节函数解决上层排版需求 —— 该分层的地方就得手动分层。
