侧边栏折叠必须用 grid_remove() 而非 destroy()，以保留组件状态和绑定；展开时用 grid() 恢复并同步更新列权重与按钮图标，滚动容器须统一使用 grid 布局。
侧边栏折叠逻辑必须用 grid_remove() 而非 destroy()
直接调用 destroy() 会彻底删除组件，再次展开时得重新构建整个导航栏，状态丢失、事件绑定失效、按钮回调函数无法恢复。正确做法是用 grid_remove() 隐藏（保留所有属性和绑定），再用 grid() 恢复布局。CustomTkinter 的 CTkFrame 和子控件都支持该方式。
常见错误现象：点击折叠后再次点击无反应，或报错 AttributeError: 'NoneType' object has no attribute 'grid'——说明你试图对已销毁的控件调用 grid()。
- 折叠时统一调用
sidebar_frame.grid_remove() - 展开时用
sidebar_frame.grid(row=0, column=0, rowspan=10, sticky="nsew")（注意保持原grid参数一致） - 按钮本身不能被
grid_remove()，否则无法再触发点击；应只隐藏其父容器（如包裹导航项的CTkFrame）
折叠按钮需绑定双态切换且更新图标文本
一个按钮既要控制显示/隐藏，又要实时反映当前状态（比如「☰」变「✕」，或文字从「收起」变「展开」），必须维护一个布尔状态变量，并在回调中同步更新 UI。CustomTkinter 没有内置 toggle 按钮，得手动实现。
使用场景：用户频繁折叠/展开，需视觉反馈避免误操作；多级菜单下还可能需同步收起子菜单。
立即学习“Python免费学习笔记（深入）”；
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
- 定义状态变量：
self.sidebar_visible = True - 回调函数内先判断状态，再执行相反操作：
if self.sidebar_visible: sidebar_frame.grid_remove(); self.toggle_btn.configure(text="►"); else: sidebar_frame.grid(...); self.toggle_btn.configure(text="◄") - 图标建议用 Unicode 字符（如
"☰"/"✕"）或CTkImage加载小尺寸 SVG/PNG，避免依赖字体渲染异常
主内容区需动态调整 grid_columnconfigure 权重
当侧边栏隐藏后，主内容区应自动撑满整行宽度，否则右侧留白难看。这不靠重设 grid 参数，而靠调整列权重（columnconfigure）让主区域“抢”到剩余空间。
性能影响：仅修改权重，不触发布局重建，响应快；但若忘记设置，折叠后界面错位明显，是用户第一眼就能察觉的问题。
- 初始化时设置：
root.grid_columnconfigure(1, weight=1)（假设侧边栏占 column=0，主内容占 column=1） - 折叠时额外加一句：
root.grid_columnconfigure(0, weight=0)，防止 column=0 仍争抢空间 - 展开时恢复：
root.grid_columnconfigure(0, weight=1)（或按需设为较小值如weight=2，使侧边栏固定宽、主区自适应）
嵌套滚动与响应式收缩需禁用 pack/place 混用
如果侧边栏内容较多（比如 20 个菜单项），需加 CTkScrollableFrame。此时务必确保整个侧边栏容器只用 grid 布局——混用 pack 或 place 会导致折叠后尺寸计算异常，甚至触发 Tkinter 的 TclError: bad grid option。
容易踩的坑：把 CTkScrollableFrame 放进 CTkFrame 后，对后者用 grid，却对前者用 pack；或者给滚动帧设了固定 height，导致折叠时高度不归零。
- 滚动帧也走
grid：scroll_frame.grid(row=1, column=0, sticky="nsew", padx=5, pady=(0,5)) - 父侧边栏帧启用
rowconfigure：sidebar_frame.grid_rowconfigure(1, weight=1)，让滚动区占满剩余高度 - 折叠前可选清空滚动内容（
for widget in scroll_frame.winfo_children(): widget.destroy()），避免残留空白
