Flutter滚动视图语义化问题：滚动时播报未标记项

问题原因 #

当你用SingleChildScrollView包裹ListView时，两个可滚动组件会生成重复的语义化节点（也就是你看到的FlutterSemanticScrollView），无障碍服务会识别到多个滚动容器。同时因为你的列表项没有设置任何语义标签，就会触发“未标记项”的播报——这个问题只在内容足够滚动时出现，是因为只有此时滚动容器的语义化节点才会被激活。

解决方案 #

方案1：移除不必要的嵌套滚动容器 #

如果SingleChildScrollView是多余的（比如你的ListView已经能处理自身滚动，外层只是为了适配布局），直接去掉SingleChildScrollView即可。比如你的代码里ListView是水平滚动，若外层垂直滚动是其他需求，可调整布局结构避免嵌套。

方案2：给列表项添加语义标签 #

用Semantics组件包裹每个列表项，明确标注item的语义信息，让无障碍服务能正确识别：

ListView.builder(
  controller: _scrollController,
  itemCount: 10,
  scrollDirection: Axis.horizontal,
  shrinkWrap: true,
  itemBuilder: (_, index) {
    return Semantics(
      label: "列表项 ${index + 1}", // 根据实际业务设置合适的标签
      child: Container(width: 100, height: 200),
    );
  },
)

方案3：禁用外层滚动容器的语义化 #

如果必须保留嵌套结构，可以给外层SingleChildScrollView设置excludeSemantics: true，让无障碍服务只识别内部ListView的语义化节点：

SingleChildScrollView(
  excludeSemantics: true,
  child: ListView.builder(
    controller: _scrollController,
    itemCount: 10,
    scrollDirection: Axis.horizontal,
    shrinkWrap: true,
    itemBuilder: (_, index) {
      return Container(width: 100, height: 200);
    },
  ),
)

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