maxLines为null时如何让CupertinoTextField占位文本自动换行

这个现象的核心原因是CupertinoTextField在maxLines设为null开启高度自适应时，内部给默认占位文本组件的maxLines硬编码为1，才会导致长占位符被截断显示省略号，不需要改动现有输入框自适应逻辑，以下两种方案都可以实现需求：

方案1：通过placeholderBuilder自定义占位组件（优先使用，无兼容问题） #

放弃直接使用placeholder参数传文本，改用组件构建回调自定义占位内容，手动给占位文本开启换行支持，原有输入交互、样式、自适应高度逻辑完全不受影响，参考代码：

return CupertinoTextField(
  controller: _textController,
  autofocus: true,
  // 移除原有placeholder参数，改用自定义构建
  placeholderBuilder: (context, placeholderTextStyle) {
    return Padding(
      // 补全垂直内边距，和原生占位符位置完全对齐
      padding: const EdgeInsets.symmetric(vertical: 7),
      child: Text(
        "This is a very long placeholder text that should wrap to the next line.",
        style: placeholderTextStyle,
        maxLines: null, // 允许占位文本自动换行
        overflow: TextOverflow.visible,
      ),
    );
  },
  maxLines: null, // 保留原有的高度自适应配置
);

该方案在Flutter 3.x全量稳定版验证生效，占位文本换行逻辑和输入正文完全一致，不会出现样式错位、交互异常的问题。

方案2：设置最大输入行数限制（适合有行数上限要求的场景） #

如果业务本身允许限制输入框的最大高度，可以给maxLines传入业务可接受的最大行数值（比如8行），同时设置minLines: 1，输入框依然会从1行开始随输入内容自适应扩展，只是不会超过你设置的最大高度，此时因为maxLines不为null，占位文本会默认支持自动换行，参考代码：

return CupertinoTextField(
  controller: _textController,
  autofocus: true,
  placeholder: "This is a very long placeholder text that should wrap to the next line.",
  minLines: 1,
  maxLines: 8, // 替换为业务允许的最大输入行数即可
);

这个方案的缺点是输入框不能无限增高，不适合需要无上限高度自适应的场景。

注意：不要尝试通过修改全局文本主题、placeholder样式的方式修复，问题根源是组件内部的渲染逻辑限制，不是样式配置问题，上述两种方式是目前最稳定的绕过方案。

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