深度介绍
Textual 是一个用 Python 写终端界面的开源框架，出品方是 Textualize，也就是排版库 Rich 背后的那家公司。装上它之后，命令行程序可以拥有按钮、表格、输入框这类真正的控件，而不再只是打印几行字。文档站把内容分成九章，从 Introduction、Tutorial 到 Guide、Devtools、Widgets、Reference、API、How To、FAQ 与 Roadmap，侧栏再按首页、指南、参考三区归置，第一次打开就知道该从哪里读起。
框架的核心能力可以数得很清楚：控件三十多种，从按钮、复选框到数据表格、单选组和 Markdown 阅读器，常用的界面元素基本都能直接拿到；事件二十六种，从窗口失焦到组件卸载都有对应钩子，交互逻辑接得上；样式属性四十多个，从对齐方式到宽高尺寸都能调。除此之外还有命令面板、异步工作线程和专门的测试支持，一个中等规模的终端工具所需的东西，文档里都有对应章节。
Textual 没有借用别人的皮肤，它自带一套叫 Textual CSS 的样式语言，让界面外观用熟悉的选择器方式去描述，还配有主题机制和动画、多屏切换等能力。配合 DOM 查询与响应式机制，界面元素之间的联动写起来不绕。同门的 Rich 负责文字排版，Textual 负责整体界面，两者可以配合使用，一个管内容怎么排，一个管窗口长什么样。对开发者来说，这意味着终端应用也能有清晰的视觉层次，而不是靠字符拼出来的边框。
官方把学习资源摆在了很显眼的位置：文档首页、控件参考、PyPI 包页、GitHub 仓库和站点图五个入口都能从页面上直接点到。入门路径也有三个口子，Getting started、Tutorial 与 Guide 各管一段，想查具体控件就翻 Widgets 参考，想动手调试则有 Devtools 与 Testing 两个专门章节。仓库里能看到源码、提交记录与问题反馈区，包页则给出安装方式和版本信息，遇到不清楚的地方，按这几条路走基本都能找到答案。
适合用它的地方大致有四类。一是终端仪表盘，把服务器状态、任务进度做成常驻界面；二是本地工具界面，给自用脚本加上设置面板和按钮，不必每次都敲参数；三是命令面板式的操作入口，用快捷键唤出搜索框，在功能之间快速跳转；四是数据工作台，表格、图表与筛选控件组合起来，边看数据边调整条件。异步工作线程让这类界面在跑任务时保持响应，不会因为一条命令没执行完就整屏卡住。
资费上没有付费档位，项目以 MIT 许可开源，代码和包都公开可取，直接从 PyPI 安装即可，商业使用也无需额外购买授权。真正的门槛是使用环境：需要先有 Python 基础，会写一点异步代码会更顺手，界面调试则要熟悉它自带的工具链。社区规模是另一个参考指标，仓库星标已经超过三万七千颗，说明有相当数量的项目在实际使用它，遇到问题时更容易找到现成的答案和示例。
上手可以按四步走：先从文档首页进 Getting started 读一遍概念，再照着 Tutorial 做出第一个界面；然后用 pip 把包装进自己的环境，把示例代码改成需要的样子；接着翻控件参考挑组件，用 Textual CSS 调外观，配合命令面板和调试工具反复运行；最后到仓库提问题或参与讨论。文档九章的排布就是按这个顺序设计的，从入门到参考各占一段，中途卡住了随时可以退回教程那一章。
产品特点
从窗口失焦、按键输入到组件卸载，每种交互都有对应的事件可挂，回调逻辑不用自己拼字符串匹配，界面行为的组织方式因此清晰很多，写复杂交互也更有底。
Textual CSS 让终端界面也能用选择器式的写法管理外观，加上主题、动画与响应式机制，四十多个样式属性够用又不至于堆成杂物间，换皮肤不用重写结构。
控件、事件、样式各自成册，教程与指南分开摆放，想系统学或随手查都能很快落到对应章节，不用在一份长文档里来回翻找，新人第一天就能跑通示例。
仓库星标达到 3.7 万以上，配合 PyPI 直装与 MIT 许可，说明这个框架已经被大量真实项目用起来，遇到问题更容易找到现成答案，长期维护的信心也更足。
最近动态
文档站、PyPI 包页与 GitHub 仓库三个入口都能直接打开，控件参考、事件参考与样式参考在文档里分章列出，命令面板与测试章节同样可用；读者从任一入口都能查到安装方式、控件用法与版本动态。
控件、事件与样式三类参考在文档站里分列成章，命令面板、工作线程与测试章节同步维护，从入门到查阅的路径都能走通，新版本的能力会先出现在文档里。
仓库星标数已超过三万七千颗，PyPI 包页持续发布版本，配合 MIT 许可与完全公开的源码，使用者可以随时跟进更新、下载包，或到仓库参与讨论与提交问题。
Textual 是一个用 Python 写终端界面的开源框架，出品方是 Textualize，也就是排版库 Rich 背后的团队。它想解决的问题很直接：命令行程序不该只能打印几行字，而应该像图形界面一样有按钮、表格、输入框和菜单。装上之后，你可以用纯 Python 搭出一套带交互的界面，事件、样式和布局都有现成的机制接管，不必手写字符边框和按键解析。文档站把内容分成九章，从入门教程到控件参考、API 与常见问题一应俱全，侧栏按首页、指南、参考三区归置，第一次打开就知道该往哪走。 能力上，它把三类参考摆得很齐：控件三十多种，覆盖按钮、复选框、数据表格、单选组与 Markdown 阅读器；事件二十六种，从窗口失焦到组件卸载都有钩子；样式属性四十多个，从对齐到宽高都能调，还配了自带的 Textual CSS 样式语言、主题机制与动画、多屏切换。命令面板、异步工作线程和测试支持则负责让界面在跑任务时保持响应。界面体系之外，文档、控件参考、PyPI 包页、GitHub 仓库与站点图五个入口都在页面上直接可达，入门也有 Getting started、Tutorial 与 Guide 三条路可选。 资费与门槛方面，项目以 MIT 许可开源，没有付费档位，从 PyPI 安装即可，商业使用也不需要额外授权；真正的门槛是要有 Python 基础，会一点异步编程会更顺手。社区规模可以参考仓库星标，已经超过三万七千颗，说明它被不少真实项目采用。上手路径也很清楚：读概念、跑教程、装包改示例、翻控件参考调样式，卡住了再回教程那一章，或者到仓库提问题。适合的场景包括终端仪表盘、本地工具界面、命令面板式操作台和数据工作台，运维脚本作者与数据工作者都能直接用上。
核验信息
本页内容来自 Textual 官方文档站、控件参考、PyPI 包页与 GitHub 仓库，控件数量、事件种类、样式属性、命令面板、工作线程与测试支持等信息均取自上述页面原文；图标与官方分享图两项素材分别来自站点资源与仓库图片。内容核对于 2026-10-04。
Textual介绍页面对您是否有帮助？
Textual