Flutter中如何获取ListView每个子项的精确位置？

核心问题点 #

1. GlobalKey重复创建：在itemBuilder里每次都新建GlobalKey，滚动重建时旧的key关联的widget已被销毁，异步回调里访问currentContext!就会触发空指针错误。
2. positions列表管理混乱：滚动时清空列表再setState，但异步回调的位置添加是滞后的，导致列表为空；且用add方法无法保证位置和index一一对应，显示时会出现索引不匹配的问题。
3. 未处理Widget销毁情况：ListView滚动时，不可见的item会被销毁，对应的GlobalKey.currentContext会变为null，直接强制解包必然报错。

修正后的代码 #

import 'package:flutter/material.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return const MaterialApp(
      home: HomePage(),
    );
  }
}

class HomePage extends StatefulWidget {
  const HomePage({Key? key}) : super(key: key);

  @override
  State<HomePage> createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  late ScrollController _controller;
  // 提前创建每个item对应的GlobalKey
  late List<GlobalKey> itemKeys;
  // 初始化与itemCount长度一致的位置列表，默认值为0
  List<double> positions = List.filled(100, 0);

  @override
  void initState() {
    super.initState();
    _controller = ScrollController();
    // 初始化GlobalKey列表
    itemKeys = List.generate(100, (index) => GlobalKey());
    _controller.addListener(() {
      setState(() {});
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: ListView.builder(
        cacheExtent: 0,
        controller: _controller,
        itemCount: 100,
        itemBuilder: (context, index) {
          final itemKey = itemKeys[index];
          WidgetsBinding.instance.addPostFrameCallback((timeStamp) {
            // 先判断currentContext是否存在，避免空指针
            if (itemKey.currentContext != null) {
              final renderBox = itemKey.currentContext!.findRenderObject() as RenderBox;
              final position = renderBox.localToGlobal(Offset.zero);
              // 直接更新对应index的位置值，保证一一对应
              setState(() {
                positions[index] = position.dy;
              });
            }
          });
          return Container(
            key: itemKey,
            child: Padding(
              padding: const EdgeInsets.all(20.0),
              child: Text("index: $index itemPosition: ${positions[index]}"),
            ),
          );
        },
      ),
    );
  }
}

关键改动说明 #

• 固定GlobalKey：在initState里提前生成所有item的GlobalKey，每个item绑定固定的key，避免重建时key失效。
• 安全的空判断：在异步回调里先检查currentContext是否不为null，再进行RenderBox的获取操作，彻底避免空指针错误。
• 位置列表一一对应：初始化时让positions长度和itemCount一致，直接更新对应index的位置值，保证显示的位置和item完全匹配，不会出现顺序混乱或索引越界。
• 简化滚动监听：滚动时只触发setState刷新UI，不需要清空列表，让可见的item自行更新位置即可。

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