在mac终端中启用鼠标滚轮滚动man文档需三步:1. 终端设置中勾选“启用鼠标报告”;2. 确保manpager=less -r(避免用more或缺失-r);3. less版本不低于590(旧版需brew升级)。

在Mac终端里查看man手册时,滚动条默认不可用,按空格或f键翻页又不够直观,必须让鼠标滚轮能直接上下滚动man文档内容。
启用终端内鼠标滚轮滚动man文档
这一步依赖终端自身的“鼠标报告”功能开启,而非系统级滚动设置。macOS原生终端(Terminal.app)从Ventura起已默认支持,但需确认当前配置未被禁用。
1、打开“终端”应用 → 顶部菜单栏点击“终端” → “设置…” → 切换到“配置文件”标签页。
2、在左侧配置文件列表中,选中你正在使用的配置(通常是“基本”或带星标的默认项)→ 点击右侧的“键盘”标签。
3、向下滚动到底部,找到“使用选项键作为元键”下方的复选框:【启用鼠标报告】 → 确保它已被勾选。
4、关闭设置窗口,新开一个终端标签页(旧窗口不继承新配置),输入 man ls 回车。
5、此时鼠标滚轮即可直接上下滚动man页面——无需按住任何修饰键,也不受“自然滚动”开关影响。
若滚动仍无效:检查man分页器是否被替换
macOS默认用less作为man分页器,它原生支持鼠标滚轮;但如果你装过zsh插件、oh-my-zsh或手动改过PAGER环境变量,可能已切换为不支持滚轮的more或其它工具。
方法一:临时验证是否是分页器问题
在终端中执行:MANPAGER=less man ls → 若此时滚轮恢复可用,说明你的全局PAGER被覆盖了。
方法二:永久修复分页器设置
编辑你的shell配置文件(如 ~/.zshrc 或 ~/.bash_profile),查找包含 export PAGER= 或 export MANPAGER= 的行 → 将其值改为 less,例如:export MANPAGER="less -R" → 保存后执行 source ~/.zshrc。
【注意】不要写成 export PAGER=more 或省略-R参数,否则中文man页会乱码且滚轮失效。
补充:确保less本身支持鼠标事件
less从v590起内置鼠标支持,macOS自带版本均满足。但若你通过Homebrew安装了旧版less(如v551),需升级:
1、终端中运行 less --version 查看版本号。
2、若低于590,执行 brew update && brew upgrade less。
3、升级完成后,重启终端,再试 man 命令。











