Flutter Windows平台下如何提升ListView鼠标滚轮滚动速度？

我之前在Flutter 3.0.4版本开发Windows应用时，也碰到过一模一样的问题：鼠标拖动ListView滚动很顺畅，但滚轮滚动时慢得像蜗牛，试了几个方法都挺管用，给你分享下：

方法一：自定义ScrollBehavior（最推荐，全局/局部都适用） #

Flutter默认的ScrollBehavior对Windows鼠标滚轮的滚动增量处理偏保守，我们可以通过自定义Behavior来放大滚轮的滚动速度：

1. 先创建一个自定义的ScrollBehavior类：

import 'package:flutter/gestures.dart';
import 'package:flutter/material.dart';

class CustomScrollBehavior extends MaterialScrollBehavior {
  // 重写鼠标滚动的模拟逻辑，放大速度倍数
  @override
  ScrollSimulation createScrollSimulation(
    ScrollMetrics position,
    double velocity,
    ScrollPhysics physics,
    BuildContext context,
  ) {
    // 这里把滚轮速度放大3倍，你可以根据自己的需求调整（建议2-5之间测试）
    velocity *= 3;
    return super.createScrollSimulation(position, velocity, physics, context);
  }

  // 确保鼠标也能触发拖动滚动（可选，防止某些场景下鼠标拖动失效）
  @override
  Set<PointerDeviceKind> get dragDevices => {
        PointerDeviceKind.touch,
        PointerDeviceKind.mouse,
      };
}

2. 全局应用到整个App（一次配置所有滚动组件生效）：

MaterialApp(
  scrollBehavior: CustomScrollBehavior(),
  home: Scaffold(
    body: ListView.builder(
      itemCount: 100,
      itemBuilder: (context, index) => ListTile(title: Text('列表项 $index')),
    ),
  ),
);

如果只想给单个ListView生效，用ScrollConfiguration包裹即可：

ScrollConfiguration(
  behavior: CustomScrollBehavior(),
  child: ListView.builder(
    // 你的ListView配置
    itemCount: 50,
    itemBuilder: (context, i) => Card(child: Padding(padding: EdgeInsets.all(16), child: Text('Card $i'))),
  ),
)

方法二：自定义ScrollPhysics（针对单个组件调整） #

如果不想全局修改，也可以给ListView单独配置自定义的滚动物理效果：

class FastScrollPhysics extends ScrollPhysics {
  final double speedMultiplier;

  const FastScrollPhysics({required this.speedMultiplier, ScrollPhysics? parent}) : super(parent: parent);

  @override
  FastScrollPhysics applyTo(ScrollPhysics? ancestor) {
    return FastScrollPhysics(speedMultiplier: speedMultiplier, parent: buildParent(ancestor));
  }

  @override
  Simulation createBallisticSimulation(ScrollMetrics position, double velocity) {
    // 放大滚轮触发的滚动速度
    velocity *= speedMultiplier;
    return super.createBallisticSimulation(position, velocity);
  }
}

然后在ListView里使用：

ListView.builder(
  physics: const FastScrollPhysics(speedMultiplier: 3.5),
  itemCount: 100,
  itemBuilder: (context, index) => ListTile(title: Text('列表项 $index')),
)

小提示 #

• 速度倍数别调得太夸张，不然滚动会变得很“冲”，建议在2-5之间反复测试找到适合的数值；
• 如果你的App用的是Cupertino风格组件，记得让自定义Behavior继承CupertinoScrollBehavior而不是MaterialScrollBehavior；
• Flutter 3.0.4版本完全兼容上述两种方法，不会出现API废弃的问题。

内容的提问来源于stack exchange，提问作者酱天小禽兽