Python rhq-menu 包完整使用指南rhq-menu是轻量级、纯Python实现的交互式命令行菜单工具包专为简化终端交互式菜单开发设计无需依赖复杂GUI库仅通过终端即可实现单选、多选、导航菜单、嵌套菜单等功能适配Windows、macOS、Linux全平台是脚本工具、CLI程序、自动化脚本交互的首选库。一、核心功能基础单选菜单终端单选选择支持上下箭头导航、回车确认多选菜单支持空格勾选、全选/反选返回多选结果列表嵌套/层级菜单支持子菜单、多级导航适合复杂功能分类自定义样式可修改选中色、提示文字、光标符号、菜单标题默认选中支持预设默认选项提升操作效率纯终端无依赖无需安装额外系统库轻量高效快速返回值选择后直接返回选项文本/索引便于业务逻辑处理二、安装方法1. 标准pip安装推荐pipinstallrhq-menu2. 国内镜像加速安装pipinstallrhq-menu-ihttps://pypi.tuna.tsinghua.edu.cn/simple3. 验证安装执行以下命令无报错即安装成功importrhq_menuprint(rhq_menu.__version__)三、核心语法与全参数解析rhq-menu核心提供3个核心函数覆盖绝大多数使用场景rhq_menu.menu()单选菜单最常用rhq_menu.checkbox()多选菜单rhq_menu.submenu()嵌套子菜单1. 单选菜单menu()完整语法rhq_menu.menu(options:list,# 必选菜单选项列表元素为字符串title:strNone,# 可选菜单标题默认无标题prompt:str请选择: ,# 可选底部提示文字default:int0,# 可选默认选中项的索引默认0第一个color:strgreen,# 可选选中项颜色支持red/green/blue/yellowcursor:str,# 可选选中光标符号return_index:boolFalse# 可选True返回索引False返回选项文本)2. 多选菜单checkbox()完整语法rhq_menu.checkbox(options:list,# 必选选项列表title:strNone,# 可选标题prompt:str请选择(空格勾选回车确认): ,# 提示文字checked_color:strgreen,# 勾选颜色cursor:str,# 光标符号return_index:boolFalse# True返回索引列表False返回文本列表)3. 嵌套菜单submenu()完整语法rhq_menu.submenu(menu_data:dict,# 必选嵌套菜单字典key标题value子选项title:str主菜单,# 主菜单标题prompt:str请选择: )四、8个实际应用案例可直接运行案例1基础单选菜单工具启动选择场景自动化脚本启动选项选择执行功能importrhq_menu# 定义选项options[数据备份,数据恢复,系统清理,退出程序]# 调用单选菜单resultrhq_menu.menu(options,title 系统工具集 ,colorblue)# 业务逻辑处理print(f\n你选择了{result})ifresult退出程序:print(程序已退出)案例2带默认选中的单选菜单场景常用选项默认选中减少操作步骤importrhq_menu options[Python,Java,C,JavaScript]# 默认选中第3个选项索引2Cresultrhq_menu.menu(options,title选择编程语言,default2,prompt请确认你的选择: )print(f选中语言{result})案例3多选菜单文件批量选择场景批量选择文件、批量执行任务importrhq_menu files[报告.docx,数据.xlsx,图片.png,日志.log]# 多选菜单selectedrhq_menu.checkbox(files,title 批量选择文件 ,checked_coloryellow)print(f\n选中的文件{selected})print(f共选择{len(selected)}个文件)案例4返回索引的菜单精准逻辑控制场景通过索引判断业务避免文本匹配错误importrhq_menu actions[查询,新增,修改,删除]# return_indexTrue 返回选中项索引indexrhq_menu.menu(actions,return_indexTrue,title数据操作)ifindex0:print(执行查询操作)elifindex3:print(执行删除操作)案例5嵌套层级菜单多级功能导航场景复杂工具、管理系统的多级菜单importrhq_menu# 定义嵌套菜单字典menu_config{用户管理:[添加用户,删除用户,修改权限],系统设置:[网络配置,存储配置,安全设置],日志查看:[运行日志,错误日志,登录日志]}# 调用嵌套菜单resultrhq_menu.submenu(menu_config)print(f\n最终选择{result})案例6自定义光标与样式个性化菜单场景定制化CLI工具提升视觉体验importrhq_menu options[开始游戏,游戏设置,关于我们]# 自定义光标为箭头颜色resultrhq_menu.menu(options,title 游戏控制台 ,cursor→,colorred,prompt请输入操作: )print(f你的操作{result})案例7结合循环的持久化菜单不退出程序场景常驻运行的脚本菜单选择后返回主菜单importrhq_menuwhileTrue:options[任务1,任务2,任务3,退出]resrhq_menu.menu(options,title 常驻任务菜单 )ifres退出:print(程序退出)breakprint(f正在执行{res}...\n)案例8菜单文件操作实战完整工具场景通过菜单选择执行文件读写操作importrhq_menudefread_file():withopen(test.txt,r,encodingutf-8)asf:print(文件内容,f.read())defwrite_file():contentinput(输入写入内容)withopen(test.txt,w,encodingutf-8)asf:f.write(content)print(写入成功)# 菜单调用opt[读取文件,写入文件,退出]whileTrue:resrhq_menu.menu(opt,title文件操作工具)ifres读取文件:read_file()elifres写入文件:write_file()else:break五、常见错误与解决方案错误1ModuleNotFoundError: No module named rhq_menu原因未安装包 / 安装环境与运行环境不一致解决重新执行pip install rhq-menu确认使用的Python解释器与pip对应如conda环境需激活后安装错误2TypeError: menu() missing 1 required positional argument: options原因未传入必选参数options菜单选项列表解决必须传递非空列表作为菜单选项如menu([选项1, 选项2])错误3菜单显示乱码Windows终端原因终端编码不支持UTF-8解决Windows终端执行chcp 65001或使用VS Code终端、PowerShell运行错误4多选菜单无法勾选 / 回车无响应原因终端不支持交互式按键如部分轻量终端解决使用系统原生终端CMD、Terminal避免IDE内置极简终端错误5IndexError: list index out of range原因default参数设置的索引超出选项列表长度解决default必须 ≥0 且 选项总数六、使用注意事项选项格式要求options必须是非空字符串列表不支持数字、None等类型终端兼容性仅支持交互式终端不支持非交互式环境如后台脚本、CI/CD无终端环境嵌套菜单限制submenu()仅支持二级嵌套主菜单子菜单不支持三级及以上深度颜色支持仅支持red/green/blue/yellow4种标准色无自定义RGB返回值规范单选返回字符串/单个索引多选返回列表/索引列表中文支持完美支持中文选项、标题无乱码问题UTF-8环境版本兼容支持Python 3.6及以上版本不兼容Python2总结rhq-menu是轻量无依赖的终端交互式菜单库核心支持单选、多选、嵌套菜单三大能力安装仅需pip install rhq-menu语法简洁参数清晰零基础可上手8个实战案例覆盖工具开发、文件操作、批量选择、常驻脚本等全场景核心避坑点确保选项为字符串列表、使用交互式终端、default索引不越界《动手学PyTorch建模与应用:从深度学习到大模型》是一本从零基础上手深度学习和大模型的PyTorch实战指南。全书共11章前6章涵盖深度学习基础包括张量运算、神经网络原理、数据预处理及卷积神经网络等后5章进阶探讨图像、文本、音频建模技术并结合Transformer架构解析大语言模型的开发实践。书中通过房价预测、图像分类等案例讲解模型构建方法每章附有动手练习题帮助读者巩固实战能力。内容兼顾数学原理与工程实现适配PyTorch框架最新技术发展趋势。