用途:在构建或调试基于 xterm.js 的终端应用时提供实践参考,尤其适用于 React 终端界面、WebSocket 终端 I/O、tmux 会话持久化、分离/重连、分屏与多窗口终端管理等场景。
主要能力:涵盖引用与状态管理(状态变更时同步清理 ref)、WebSocket 消息语义区分(disconnect 为优雅断开,close 会强制关闭并杀死会话)、React 自定义 Hook 抽取时共享 ref 的传递、终端初始化需非零容器尺寸(用 visibility 隐藏而非 display:none)、useEffect 依赖与提前返回、会话命名与重连、多窗口输出按归属路由、重构后真实使用测试、诊断日志、多步状态变更的副作用清单、tmux 分屏下关闭 convertEol、输出期间避免 resize、两步 resize 技巧(按行而非列调整)、resize 后清空写队列、重连输出守卫、延迟操作取消,以及 tmux 会话跳过 ResizeObserver 等。
使用方式:资料未提供安装命令或调用方式,仅给出代码模式与检查清单,需结合自身项目实现。
限制:内容为经验性最佳实践,未说明适用版本、平台或收费情况;具体接口与行为需以实际后端和 xterm.js 版本为准。