1. QSplitter 滑动窗口自由伸缩到底解决什么问题桌面端多面板布局里最容易被用户吐槽的就是「面板不能拖」或者「拖到一半卡住」。QSplitter 是 Qt 提供的分割器控件它能把一个窗口横向或纵向切成若干块用户拖动中间的分隔条就能自由调整各块大小。听起来简单但真正落地时会遇到一堆细节分隔条太细点不中、拖到边界没有回弹、面板折叠后按钮位置错乱、鼠标悬停才显示折叠按钮……这些都不是 QSplitter 本身能自动搞定的。这篇聚焦的就是「滑动窗口自由伸缩」这个交互场景。所谓滑动窗口是指面板可以像抽屉一样展开收起同时中间的 QSplitter 又允许用户手动拖拽调整比例。两者结合才能做出类似 IDE 侧边栏那种顺滑体验。适合谁看如果你正在用 Qt Widgets 做桌面工具、编辑器、监控面板需要多面板可拖拽布局那这篇的配置和排障步骤可以直接抄。核心检索词先明确QSplitter 滑动窗口自由伸缩本质是 QSplitter 的尺寸策略 拖拽事件绑定 最小最大尺寸约束三件事的组合。很多人只写了setSizes就以为完事结果用户一拖就崩。下面从场景拆解开始一步步给出可复制的实现。先说我踩过的坑早期我直接用resize去改子控件宽度结果 QSplitter 根本不认拖拽后布局立刻回弹。后来才明白QSplitter 管理子控件尺寸必须走setSizes而且尺寸列表的顺序和addWidget的顺序严格对应。这个认知是后面所有配置的基础。另外滑动窗口的「自由伸缩」有两层含义一是用户手动拖分隔条二是点击按钮自动展开/收起。前者靠 QSplitter 原生能力后者需要自己算尺寸并调用setSizes。两者要共享同一套最小/最大宽度约束否则会出现「手动拖到 300px点收起按钮却跳到 0再点展开回不到 300」的尴尬。所以整篇的结构是先讲清楚尺寸策略和约束怎么配再讲拖拽事件和悬停按钮怎么绑然后给完整可运行代码接着验证请求式的检查步骤最后把常见报错逐个排掉。每一段都尽量给命令、参数和结果说明保证你能跟着做出来。2. TaoToken 前置准备把模型对话接进你的 Qt 调试流程写 Qt 布局代码时我经常需要一边调 UI 一边问模型「这个信号槽为什么没触发」。如果每次都要切浏览器效率很低。TaoToken 提供了一套兼容 OpenAI 风格的 API可以把它接进你的开发工具链让模型对话、代码补全、报错解释都在本地完成。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。这一步不是必须的但如果你想让后面的排障更顺建议先拿到 Key。操作路径很简单打开控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 在 API Keys 页面创建一个新 Key。创建时注意权限范围调试用途选默认即可。拿到 Key 后模型对话入口在 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 你可以先在那里试一句「QSplitter setSizes 不生效怎么办」确认通道正常。如果你打算长期用模型辅助编码Coding Plan 更适合入口是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。它按周期计费适合每天都要问代码问题的场景。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有 Base URL、鉴权方式和各语言示例。这里要强调三件套Base URL、Key、Model ID。无论你用 Cline、Codex 还是 Claude Code配置时这三项必须齐全。Base URL 填https://taotoken.net/apiKey 填你刚创建的Model ID 按文档里列出的可用模型填。少任何一项都会报 401 或 model not found。举个实际用法我在调 QSplitter 的splitterMoved信号时模型一直提示我检查connect的返回值。后来我把connect的返回值打印出来发现是 false原因是信号参数写成了(int)而实际是(int, int)。这种细节靠搜索引擎很慢用模型对话几秒就定位了。所以前置准备这一步本质是给自己配一个随叫随到的排障助手。如果你暂时不想接 API也可以跳过直接看后面的代码。但建议至少把 API Keys 页面收藏后面排 401 时会用到。3. 可复制配置QSplitter 尺寸策略与拖拽事件绑定这一节是核心直接给可复制的代码和配置。先讲尺寸策略再讲事件绑定最后给完整的slidingwindow.h和slidingwindow.cpp关键片段。尺寸策略的关键是setSizes和setStretchFactor的配合。setSizes接收一个QListint按子控件添加顺序设置初始宽度。setStretchFactor决定窗口整体缩放时哪个面板优先伸缩。我的经验是内容面板设 stretch 1列表面板设 stretch 0这样拉大窗口时内容区先变宽列表区保持稳定。最小/最大宽度约束必须设否则用户能把面板拖到 0 宽按钮就找不到了。代码里contentFrame-setMinimumWidth(405)和listFrame-setMaximumWidth(660 - 405)就是干这个的。注意最大值要用窗口总宽减去内容区最小宽这样两边约束才自洽。拖拽事件绑定分两块一是 QSplitter 自带的splitterMoved(int pos, int index)信号用来在拖动后更新按钮位置和图标二是自定义的mousePressEvent/mouseMoveEvent/mouseReleaseEvent用来实现无边框窗口的拖动。后者容易和 QSplitter 的拖拽冲突所以要用eventFilter在子控件上做悬停检测而不是直接重写子控件的鼠标事件。下面是可复制的 settings 片段如果你用 CMake 构建CMakeLists.txt里要确保链接 Widgets 模块cmake_minimum_required(VERSION 3.16) project(SlidingWindowDemo LANGUAGES CXX) set(CMAKE_CXX_STANDARD 17) set(CMAKE_AUTOMOC ON) set(CMAKE_AUTORCC ON) find_package(Qt6 REQUIRED COMPONENTS Widgets) add_executable(SlidingWindowDemo main.cpp slidingwindow.cpp slidingwindow.h ) target_link_libraries(SlidingWindowDemo PRIVATE Qt6::Widgets)如果你用 qmake.pro文件这样写QT core gui widgets TARGET SlidingWindowDemo TEMPLATE app SOURCES main.cpp slidingwindow.cpp HEADERS slidingwindow.h RESOURCES res.qrc资源文件res.qrc里放左右箭头图标RCC qresource prefix/ fileleft.png/file fileright.png/file /qresource /RCC核心的尺寸与事件配置在构造函数里完成。关键参数我列成表格方便对照参数值作用setHandleWidth1分隔条宽度太宽影响美观太细难点中contentFrame-setMinimumWidth405内容区最小宽防止拖没listFrame-setMaximumWidth255列表区最大宽660-405 得来setMouseTrackingtrue不按键也能触发 mouseMoveEventinstallEventFilterthis在子控件上做悬停检测setMouseTracking(true)这行特别重要。默认情况下只有按下鼠标才会触发mouseMoveEvent。如果你想让按钮在鼠标悬停时就显示必须开启 mouse tracking否则eventFilter里的QEvent::MouseMove根本收不到。拖拽事件绑定的代码片段contentFrame-setMouseTracking(true); listFrame-setMouseTracking(true); contentFrame-installEventFilter(this); listFrame-installEventFilter(this); connect(splitter, SIGNAL(splitterMoved(int,int)), this, SLOT(slotSplitterMoved(int,int))); connect(pushButton, SIGNAL(clicked()), this, SLOT(slotClickedBtn()));slotClickedBtn里用setSizes做展开收起void SlidingWindow::slotClickedBtn() { QListint sizeList; sizeList.clear(); if (listFrame-width() ! 0) { sizeList.append(660); sizeList.append(0); } else { sizeList.append(475); sizeList.append(660 - 475); } splitter-setSizes(sizeList); setBtnIcon(); setBtnPos(); pushButton-hide(); }注意setSizes的列表长度必须和子控件数量一致否则 Qt 会忽略这次调用。这是很多人「点了没反应」的根本原因。4. 验证请求与成功结果手动拖拽与边界回弹检查代码写完不算完必须验证。这一节给一套可执行的检查步骤你照着做一遍就能确认滑动窗口是否真的自由伸缩。第一步编译运行。用 CMake 的话cmake -B build -DCMAKE_PREFIX_PATH/path/to/Qt6 cmake --build build ./build/SlidingWindowDemo运行后应该看到一个 660x460 的无边框窗口左边黑色内容区右边深灰列表区中间一条 1px 白色分隔条。第二步手动拖拽分隔条。把鼠标移到分隔条上光标应该变成左右箭头。按住往左拖列表区变窄内容区变宽。拖到内容区宽度接近 405 时应该拖不动了这就是最小宽度约束生效。往右拖列表区变宽到 255 时停住这是最大宽度约束。第三步检查边界回弹。把分隔条拖到最左然后松开。观察按钮图标是否从右箭头变成左箭头。再点击按钮列表区应该完全收起内容区占满 660。再点一次列表区恢复到 185 宽660-475内容区回到 475。如果恢复的宽度和你拖拽前不一致说明setSizes里的数值写死了应该改成记录拖拽前的实际宽度。第四步验证悬停按钮。鼠标不按键慢慢移到内容区右边缘。按钮应该在鼠标进入按钮区域时显示离开时隐藏。如果按钮一直不显示检查setMouseTracking(true)是否漏了或者eventFilter里rect.contains(mouseMove-pos())的坐标系是否搞错。注意mouseMove-pos()是相对于被过滤控件的坐标不是全局坐标。第五步验证窗口拖动。按住内容区空白处拖动整个窗口应该跟着移动。如果拖不动检查mousePressEvent里bPressFlag是否置 true以及mouseMoveEvent里QCursor::pos() - dragPosition的计算。这里有个小技巧QPoint realPos(QCursor::pos() - this-pos())可以避免类型转换直接得到相对窗口的位置。成功的结果应该是拖拽顺滑无卡顿边界有明确阻挡按钮图标随状态切换悬停显示灵敏窗口拖动跟手。如果任何一项不满足去下一节对号入座。我实测下来最容易出问题的是坐标系。eventFilter里收到的mouseMove-pos()是相对于contentFrame的而pushButton-frameGeometry()是相对于父窗口的。两者不在同一坐标系直接contains会判断错误。正确做法是用pushButton-geometry()并转换坐标或者把按钮的父控件设成contentFrame让坐标系一致。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth这一节把接入和运行过程中最常见的报错逐个拆解。每个报错给现象、原因、解决步骤。401 Unauthorized。现象调用模型 API 时返回 401。原因通常是 Key 没填、填错或者 Base URL 写成了带路径的完整地址。解决检查三件套是否齐全。Base URL 必须是https://taotoken.net/api不要多加/v1或/chat/completions。Key 从控制台复制时注意不要带空格。如果用的是 Cline 或 Codex检查配置文件里的字段名是否正确比如 Codex 的auth.json里字段是OPENAI_API_KEY还是api_key不同版本不一样。local proxy failed。现象本地工具报「local proxy failed」或「connection refused」。原因通常是本地代理端口没开或者工具配置里填了127.0.0.1:xxxx但实际没有服务在监听。解决先确认你的网络环境能直接访问 API 地址不需要额外代理。如果工具默认开了代理开关把它关掉改成直连。检查配置文件里是否有proxy字段有的话删掉或改成空。reading choices 报错。现象返回的 JSON 解析失败提示 reading choices 时 undefined。原因通常是返回体不是预期的 OpenAI 格式可能是鉴权失败返回了错误对象也可能是 Model ID 填错导致返回了别的结构。解决先把原始返回打印出来看error字段。如果是model not found去文档里核对可用 Model ID。如果是invalid api key回到 401 的处理。确认返回体里有choices数组后再检查解析代码。OAuth 相关报错。现象Claude Code 或类似工具提示 OAuth 失败、token 过期。原因这类工具默认走 OAuth 登录但你要接的是 API Key 模式。解决在工具配置里切换到 API Key 认证填入 Base URL 和 Key。Claude Code 的配置入口在 https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 里面有 Anthropic 兼容模式的配置说明。注意 OAuth 和 API Key 是两套认证不要混用。QSplitter setSizes 不生效。现象调用setSizes后布局没变化。原因列表长度和子控件数量不一致或者子控件的 min/max 约束把目标尺寸卡死了。解决打印splitter-count()确认数量检查每个子控件的minimumWidth和maximumWidth是否允许目标值。比如你想把列表区设成 0但它的minimumWidth是 100那就永远收不起来。按钮位置错乱。现象拖动分隔条后折叠按钮跑到面板外面。原因setBtnPos里用的宽度是旧的没有在splitterMoved后重新计算。解决在slotSplitterMoved里调用setBtnPos并且用contentFrame-width()而不是固定值。另外注意resizeEvent里也要更新按钮位置。鼠标悬停不触发。现象鼠标移到按钮区域按钮不显示。原因setMouseTracking没开或者eventFilter安装在了错误的控件上。解决确认contentFrame和listFrame都调用了setMouseTracking(true)和installEventFilter(this)。如果还是不行在eventFilter里加qDebug()打印事件类型确认MouseMove是否到达。无边框窗口拖动和 QSplitter 拖拽冲突。现象拖分隔条时整个窗口跟着动。原因mousePressEvent在父窗口捕获了事件QSplitter 没收到。解决在mousePressEvent里判断点击位置是否在分隔条上如果是就event-ignore()让事件继续传递。或者干脆把窗口拖动逻辑放到标题栏区域不要全窗口捕获。排障的核心思路是先确认 API 通道正常用模型对话试一句再确认 Qt 信号槽连接成功打印 connect 返回值最后确认尺寸约束自洽打印 min/max 和目标值。三步走完基本没有解决不了的问题。6. 把滑动窗口接进你的长期编码工作流代码跑通只是第一步。真正提升效率的是把模型对话接进日常编码流程让排障和写配置变成一句话的事。如果你每天都要调 Qt 布局、写信号槽、查报错建议用 Coding Plan入口是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。它比按次调用更适合高频场景。接入方式很简单在 Cline 或 Codex 里填三件套。Base URL 用https://taotoken.net/apiKey 用控制台创建的Model ID 按文档选。Cline 的 MCP 配置里把这三项填进对应字段即可。Codex 的auth.json里注意字段名不同版本有差异以文档为准。Claude Code 的 Anthropic 兼容配置在 https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 。配置完成后你可以直接在编辑器里问「QSplitter 的 splitterMoved 信号参数是什么」模型会给出准确答案不用切浏览器。遇到 401 或 reading choices 报错也可以直接把报错贴进去模型会告诉你检查哪一项。最后给一个实用技巧把本篇的slidingwindow.cpp存成模板下次新建 Qt 项目时直接复制。尺寸策略和事件绑定这两块基本不用改只需要调整setMinimumWidth和setMaximumWidth的数值。按钮图标换成你自己的资源路径即可。这样每次做多面板布局十分钟就能搭好可伸缩框架。如果你在拖拽边界回弹上遇到问题优先检查setSizes的数值是否和 min/max 约束冲突。这是最高频的坑没有之一。
1. QSplitter 滑动窗口自由伸缩到底解决什么问题桌面端多面板布局里最容易被用户吐槽的就是「面板不能拖」或者「拖到一半卡住」。QSplitter 是 Qt 提供的分割器控件它能把一个窗口横向或纵向切成若干块用户拖动中间的分隔条就能自由调整各块大小。听起来简单但真正落地时会遇到一堆细节分隔条太细点不中、拖到边界没有回弹、面板折叠后按钮位置错乱、鼠标悬停才显示折叠按钮……这些都不是 QSplitter 本身能自动搞定的。这篇聚焦的就是「滑动窗口自由伸缩」这个交互场景。所谓滑动窗口是指面板可以像抽屉一样展开收起同时中间的 QSplitter 又允许用户手动拖拽调整比例。两者结合才能做出类似 IDE 侧边栏那种顺滑体验。适合谁看如果你正在用 Qt Widgets 做桌面工具、编辑器、监控面板需要多面板可拖拽布局那这篇的配置和排障步骤可以直接抄。核心检索词先明确QSplitter 滑动窗口自由伸缩本质是 QSplitter 的尺寸策略 拖拽事件绑定 最小最大尺寸约束三件事的组合。很多人只写了setSizes就以为完事结果用户一拖就崩。下面从场景拆解开始一步步给出可复制的实现。先说我踩过的坑早期我直接用resize去改子控件宽度结果 QSplitter 根本不认拖拽后布局立刻回弹。后来才明白QSplitter 管理子控件尺寸必须走setSizes而且尺寸列表的顺序和addWidget的顺序严格对应。这个认知是后面所有配置的基础。另外滑动窗口的「自由伸缩」有两层含义一是用户手动拖分隔条二是点击按钮自动展开/收起。前者靠 QSplitter 原生能力后者需要自己算尺寸并调用setSizes。两者要共享同一套最小/最大宽度约束否则会出现「手动拖到 300px点收起按钮却跳到 0再点展开回不到 300」的尴尬。所以整篇的结构是先讲清楚尺寸策略和约束怎么配再讲拖拽事件和悬停按钮怎么绑然后给完整可运行代码接着验证请求式的检查步骤最后把常见报错逐个排掉。每一段都尽量给命令、参数和结果说明保证你能跟着做出来。2. TaoToken 前置准备把模型对话接进你的 Qt 调试流程写 Qt 布局代码时我经常需要一边调 UI 一边问模型「这个信号槽为什么没触发」。如果每次都要切浏览器效率很低。TaoToken 提供了一套兼容 OpenAI 风格的 API可以把它接进你的开发工具链让模型对话、代码补全、报错解释都在本地完成。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。这一步不是必须的但如果你想让后面的排障更顺建议先拿到 Key。操作路径很简单打开控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 在 API Keys 页面创建一个新 Key。创建时注意权限范围调试用途选默认即可。拿到 Key 后模型对话入口在 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 你可以先在那里试一句「QSplitter setSizes 不生效怎么办」确认通道正常。如果你打算长期用模型辅助编码Coding Plan 更适合入口是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。它按周期计费适合每天都要问代码问题的场景。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有 Base URL、鉴权方式和各语言示例。这里要强调三件套Base URL、Key、Model ID。无论你用 Cline、Codex 还是 Claude Code配置时这三项必须齐全。Base URL 填https://taotoken.net/apiKey 填你刚创建的Model ID 按文档里列出的可用模型填。少任何一项都会报 401 或 model not found。举个实际用法我在调 QSplitter 的splitterMoved信号时模型一直提示我检查connect的返回值。后来我把connect的返回值打印出来发现是 false原因是信号参数写成了(int)而实际是(int, int)。这种细节靠搜索引擎很慢用模型对话几秒就定位了。所以前置准备这一步本质是给自己配一个随叫随到的排障助手。如果你暂时不想接 API也可以跳过直接看后面的代码。但建议至少把 API Keys 页面收藏后面排 401 时会用到。3. 可复制配置QSplitter 尺寸策略与拖拽事件绑定这一节是核心直接给可复制的代码和配置。先讲尺寸策略再讲事件绑定最后给完整的slidingwindow.h和slidingwindow.cpp关键片段。尺寸策略的关键是setSizes和setStretchFactor的配合。setSizes接收一个QListint按子控件添加顺序设置初始宽度。setStretchFactor决定窗口整体缩放时哪个面板优先伸缩。我的经验是内容面板设 stretch 1列表面板设 stretch 0这样拉大窗口时内容区先变宽列表区保持稳定。最小/最大宽度约束必须设否则用户能把面板拖到 0 宽按钮就找不到了。代码里contentFrame-setMinimumWidth(405)和listFrame-setMaximumWidth(660 - 405)就是干这个的。注意最大值要用窗口总宽减去内容区最小宽这样两边约束才自洽。拖拽事件绑定分两块一是 QSplitter 自带的splitterMoved(int pos, int index)信号用来在拖动后更新按钮位置和图标二是自定义的mousePressEvent/mouseMoveEvent/mouseReleaseEvent用来实现无边框窗口的拖动。后者容易和 QSplitter 的拖拽冲突所以要用eventFilter在子控件上做悬停检测而不是直接重写子控件的鼠标事件。下面是可复制的 settings 片段如果你用 CMake 构建CMakeLists.txt里要确保链接 Widgets 模块cmake_minimum_required(VERSION 3.16) project(SlidingWindowDemo LANGUAGES CXX) set(CMAKE_CXX_STANDARD 17) set(CMAKE_AUTOMOC ON) set(CMAKE_AUTORCC ON) find_package(Qt6 REQUIRED COMPONENTS Widgets) add_executable(SlidingWindowDemo main.cpp slidingwindow.cpp slidingwindow.h ) target_link_libraries(SlidingWindowDemo PRIVATE Qt6::Widgets)如果你用 qmake.pro文件这样写QT core gui widgets TARGET SlidingWindowDemo TEMPLATE app SOURCES main.cpp slidingwindow.cpp HEADERS slidingwindow.h RESOURCES res.qrc资源文件res.qrc里放左右箭头图标RCC qresource prefix/ fileleft.png/file fileright.png/file /qresource /RCC核心的尺寸与事件配置在构造函数里完成。关键参数我列成表格方便对照参数值作用setHandleWidth1分隔条宽度太宽影响美观太细难点中contentFrame-setMinimumWidth405内容区最小宽防止拖没listFrame-setMaximumWidth255列表区最大宽660-405 得来setMouseTrackingtrue不按键也能触发 mouseMoveEventinstallEventFilterthis在子控件上做悬停检测setMouseTracking(true)这行特别重要。默认情况下只有按下鼠标才会触发mouseMoveEvent。如果你想让按钮在鼠标悬停时就显示必须开启 mouse tracking否则eventFilter里的QEvent::MouseMove根本收不到。拖拽事件绑定的代码片段contentFrame-setMouseTracking(true); listFrame-setMouseTracking(true); contentFrame-installEventFilter(this); listFrame-installEventFilter(this); connect(splitter, SIGNAL(splitterMoved(int,int)), this, SLOT(slotSplitterMoved(int,int))); connect(pushButton, SIGNAL(clicked()), this, SLOT(slotClickedBtn()));slotClickedBtn里用setSizes做展开收起void SlidingWindow::slotClickedBtn() { QListint sizeList; sizeList.clear(); if (listFrame-width() ! 0) { sizeList.append(660); sizeList.append(0); } else { sizeList.append(475); sizeList.append(660 - 475); } splitter-setSizes(sizeList); setBtnIcon(); setBtnPos(); pushButton-hide(); }注意setSizes的列表长度必须和子控件数量一致否则 Qt 会忽略这次调用。这是很多人「点了没反应」的根本原因。4. 验证请求与成功结果手动拖拽与边界回弹检查代码写完不算完必须验证。这一节给一套可执行的检查步骤你照着做一遍就能确认滑动窗口是否真的自由伸缩。第一步编译运行。用 CMake 的话cmake -B build -DCMAKE_PREFIX_PATH/path/to/Qt6 cmake --build build ./build/SlidingWindowDemo运行后应该看到一个 660x460 的无边框窗口左边黑色内容区右边深灰列表区中间一条 1px 白色分隔条。第二步手动拖拽分隔条。把鼠标移到分隔条上光标应该变成左右箭头。按住往左拖列表区变窄内容区变宽。拖到内容区宽度接近 405 时应该拖不动了这就是最小宽度约束生效。往右拖列表区变宽到 255 时停住这是最大宽度约束。第三步检查边界回弹。把分隔条拖到最左然后松开。观察按钮图标是否从右箭头变成左箭头。再点击按钮列表区应该完全收起内容区占满 660。再点一次列表区恢复到 185 宽660-475内容区回到 475。如果恢复的宽度和你拖拽前不一致说明setSizes里的数值写死了应该改成记录拖拽前的实际宽度。第四步验证悬停按钮。鼠标不按键慢慢移到内容区右边缘。按钮应该在鼠标进入按钮区域时显示离开时隐藏。如果按钮一直不显示检查setMouseTracking(true)是否漏了或者eventFilter里rect.contains(mouseMove-pos())的坐标系是否搞错。注意mouseMove-pos()是相对于被过滤控件的坐标不是全局坐标。第五步验证窗口拖动。按住内容区空白处拖动整个窗口应该跟着移动。如果拖不动检查mousePressEvent里bPressFlag是否置 true以及mouseMoveEvent里QCursor::pos() - dragPosition的计算。这里有个小技巧QPoint realPos(QCursor::pos() - this-pos())可以避免类型转换直接得到相对窗口的位置。成功的结果应该是拖拽顺滑无卡顿边界有明确阻挡按钮图标随状态切换悬停显示灵敏窗口拖动跟手。如果任何一项不满足去下一节对号入座。我实测下来最容易出问题的是坐标系。eventFilter里收到的mouseMove-pos()是相对于contentFrame的而pushButton-frameGeometry()是相对于父窗口的。两者不在同一坐标系直接contains会判断错误。正确做法是用pushButton-geometry()并转换坐标或者把按钮的父控件设成contentFrame让坐标系一致。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth这一节把接入和运行过程中最常见的报错逐个拆解。每个报错给现象、原因、解决步骤。401 Unauthorized。现象调用模型 API 时返回 401。原因通常是 Key 没填、填错或者 Base URL 写成了带路径的完整地址。解决检查三件套是否齐全。Base URL 必须是https://taotoken.net/api不要多加/v1或/chat/completions。Key 从控制台复制时注意不要带空格。如果用的是 Cline 或 Codex检查配置文件里的字段名是否正确比如 Codex 的auth.json里字段是OPENAI_API_KEY还是api_key不同版本不一样。local proxy failed。现象本地工具报「local proxy failed」或「connection refused」。原因通常是本地代理端口没开或者工具配置里填了127.0.0.1:xxxx但实际没有服务在监听。解决先确认你的网络环境能直接访问 API 地址不需要额外代理。如果工具默认开了代理开关把它关掉改成直连。检查配置文件里是否有proxy字段有的话删掉或改成空。reading choices 报错。现象返回的 JSON 解析失败提示 reading choices 时 undefined。原因通常是返回体不是预期的 OpenAI 格式可能是鉴权失败返回了错误对象也可能是 Model ID 填错导致返回了别的结构。解决先把原始返回打印出来看error字段。如果是model not found去文档里核对可用 Model ID。如果是invalid api key回到 401 的处理。确认返回体里有choices数组后再检查解析代码。OAuth 相关报错。现象Claude Code 或类似工具提示 OAuth 失败、token 过期。原因这类工具默认走 OAuth 登录但你要接的是 API Key 模式。解决在工具配置里切换到 API Key 认证填入 Base URL 和 Key。Claude Code 的配置入口在 https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 里面有 Anthropic 兼容模式的配置说明。注意 OAuth 和 API Key 是两套认证不要混用。QSplitter setSizes 不生效。现象调用setSizes后布局没变化。原因列表长度和子控件数量不一致或者子控件的 min/max 约束把目标尺寸卡死了。解决打印splitter-count()确认数量检查每个子控件的minimumWidth和maximumWidth是否允许目标值。比如你想把列表区设成 0但它的minimumWidth是 100那就永远收不起来。按钮位置错乱。现象拖动分隔条后折叠按钮跑到面板外面。原因setBtnPos里用的宽度是旧的没有在splitterMoved后重新计算。解决在slotSplitterMoved里调用setBtnPos并且用contentFrame-width()而不是固定值。另外注意resizeEvent里也要更新按钮位置。鼠标悬停不触发。现象鼠标移到按钮区域按钮不显示。原因setMouseTracking没开或者eventFilter安装在了错误的控件上。解决确认contentFrame和listFrame都调用了setMouseTracking(true)和installEventFilter(this)。如果还是不行在eventFilter里加qDebug()打印事件类型确认MouseMove是否到达。无边框窗口拖动和 QSplitter 拖拽冲突。现象拖分隔条时整个窗口跟着动。原因mousePressEvent在父窗口捕获了事件QSplitter 没收到。解决在mousePressEvent里判断点击位置是否在分隔条上如果是就event-ignore()让事件继续传递。或者干脆把窗口拖动逻辑放到标题栏区域不要全窗口捕获。排障的核心思路是先确认 API 通道正常用模型对话试一句再确认 Qt 信号槽连接成功打印 connect 返回值最后确认尺寸约束自洽打印 min/max 和目标值。三步走完基本没有解决不了的问题。6. 把滑动窗口接进你的长期编码工作流代码跑通只是第一步。真正提升效率的是把模型对话接进日常编码流程让排障和写配置变成一句话的事。如果你每天都要调 Qt 布局、写信号槽、查报错建议用 Coding Plan入口是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。它比按次调用更适合高频场景。接入方式很简单在 Cline 或 Codex 里填三件套。Base URL 用https://taotoken.net/apiKey 用控制台创建的Model ID 按文档选。Cline 的 MCP 配置里把这三项填进对应字段即可。Codex 的auth.json里注意字段名不同版本有差异以文档为准。Claude Code 的 Anthropic 兼容配置在 https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 。配置完成后你可以直接在编辑器里问「QSplitter 的 splitterMoved 信号参数是什么」模型会给出准确答案不用切浏览器。遇到 401 或 reading choices 报错也可以直接把报错贴进去模型会告诉你检查哪一项。最后给一个实用技巧把本篇的slidingwindow.cpp存成模板下次新建 Qt 项目时直接复制。尺寸策略和事件绑定这两块基本不用改只需要调整setMinimumWidth和setMaximumWidth的数值。按钮图标换成你自己的资源路径即可。这样每次做多面板布局十分钟就能搭好可伸缩框架。如果你在拖拽边界回弹上遇到问题优先检查setSizes的数值是否和 min/max 约束冲突。这是最高频的坑没有之一。
![题解：洛谷 AT_abc438_c [ABC438C] 1D puyopuyo](http://pic.xiahunao.cn/yaotu/题解：洛谷 AT_abc438_c [ABC438C] 1D puyopuyo)
