Windows Terminal 中 closeOnExit 配置项与终端连接状态机的演进解析【免费下载链接】terminalThe new Windows Terminal and the original Windows console host, all in the same place!项目地址: https://gitcode.com/GitHub_Trending/term/terminal本文基于 Windows Terminal 仓库中的设计规格书 Improvements to CloseOnExit讲解closeOnExit配置项从布尔值演进为枚举字符串的完整设计过程以及ITerminalConnection接口为此引入的连接状态机ConnectionState枚举与StateChanged事件。读完后你将理解终端如何区分“正常退出”与“异常失败”两种结束状态、每种closeOnExit取值下的具体关闭行为并能结合仓库源码与单元测试验证这些行为的真实实现。背景为什么需要改进 closeOnExit原始规格书issue #2563作者 Dustin Howett2019 年提出开篇即指出其动机本规格描述了对closeOnExit配置文件特性和ITerminalConnection接口的改进它将提供更大的灵活性并允许我们在面对不可靠软件时给出更合理的默认值。在旧实现中closeOnExit只是一个布尔开关要么“进程退出就关窗口”要么“永不自动关”。这在遇到不可靠软件时暴露出两个问题用户 shell 配置错误比如commandline指向不存在的程序时终端启动即进程立即退出closeOnExit: true会让窗口一闪而过用户根本看不到任何错误提示进程因报错而退出退出码非 0时用户可能希望窗口保留以查看错误输出但布尔值无法区分“正常退出”和“失败退出”。规格书还提到ConEmu 等其他终端模拟器也有类似特性可作为设计参考。解决思路是把“连接是否结束”细化为一个有方向的状态机让应用而非连接本身根据状态与配置共同决定是否关闭面板。ITerminalConnection 接口的状态机设计规格书的核心改动是给ITerminalConnection接口增加了状态枚举和状态迁移事件枚举TerminalConnection::ConnectionState定义为NotConnected所有新连接从该状态开始Connecting连接已发起但尚未完成Connected连接处于活动状态Closing连接正在关闭通常是主动请求Closed连接已关闭可以是主动请求也可以是远端进程成功终止Failed连接被非预期地终止失败。事件StateChanged(ITerminalConnection, IInspectable)IInspectable参数是为类型化事件处理器所必需但不携带有效载荷原有的TerminalDisconnected事件被StateChanged取代而移除规格书明确要求符合规范的实现必须把状态视为有向无环图DAG状态不允许逆向迁移并且可以提供一个辅助类来管理状态迁移。当前仓库中的接口定义与规格书完全一致见 ITerminalConnection.idlenum ConnectionState { NotConnected 0, Connecting, Connected, Closing, Closed, Failed }; interface ITerminalConnection { void Initialize(Windows.Foundation.Collections.ValueSet settings); void Start(); void WriteInput(Char[] data); void Resize(UInt32 rows, UInt32 columns); void Close(); event TerminalOutputHandler TerminalOutput; event Windows.Foundation.TypedEventHandlerITerminalConnection, Object StateChanged; Guid SessionId { get; }; ConnectionState State { get; }; };规格书中提到的“辅助类管理状态迁移”由 BaseTerminalConnection.h 落实基类持有_connectionState成员暴露State()只读访问器和StateChanged类型化事件所有连接实现ConPTY 连接、Azure 连接等通过基类的状态迁移逻辑更新状态并触发StateChanged。TerminalControl 的事件投影规格书规定是否关闭承载连接的面板由应用层决定因此TerminalControl上表达力不足的Close事件被移除替换为ConnectionStateChanged事件同时TerminalControl新增ConnectionState属性直接投影其连接的State规格书注明这是为将来 Xaml 数据绑定预留的见“未来考虑”一节。在应用层这一事件链路的消费方是 TerminalPaneContent.cpp构造函数中通过_setupControlEvents()订阅TerminalControl.ConnectionStateChanged由_controlConnectionStateChangedHandler处理其核心逻辑忠实还原了规格书中的职责划分“Pane 负责根据所承载 profile 的配置做出最终关闭决定”safe_void_coroutine TerminalPaneContent::_controlConnectionStateChangedHandler(...) { ConnectionStateChanged.raise(sender, args); auto newConnectionState ConnectionState::Closed; if (const auto coreState sender.try_asICoreState()) { newConnectionState coreState.ConnectionState(); } const auto previousConnectionState std::exchange(_connectionState, newConnectionState); if (newConnectionState ConnectionState::Closed) { // Pane doesnt care if the connection isnt entering a terminal state. co_return; } ... const auto mode _profile.CloseOnExit(); if ( (mode CloseOnExitMode::Always) || (mode ! CloseOnExitMode::Never newConnectionState ConnectionState::Closed) || (mode CloseOnExitMode::Automatic _isDefTermSession)) { CloseRequested.raise(nullptr, nullptr); } }从源码结构看这里还体现了两条规格书精神的延伸防误闪保护如果连接在从未真正Connected之前就进入Failed例如startingDirectory配错导致进程根本没起来即使配置了closeOnExit: always也不会关闭面板——这正是规格书中 Reliability 一节“Windows Terminal 不再因用户 shell 不存在而在启动时立即终止”的落地Automatic 模式当前实现比规格书原始三值多出一个automatic模式用于 defterm 会话移交handoff等场景保证此类会话即使命令失败也会关闭面板避免 Windows Terminal 窗口被随机拉起源码注释中引用了相关讨论。closeOnExit 配置项取值、默认值与布尔值兼容规格书规定原有的布尔型closeOnExit被替换为支持枚举字符串的键取值行为always承载该 profile 的标签页/面板在连接进入任何终态时总是被关闭graceful仅当连接进入Closed终态正常退出时才关闭Failed时保留never永不自动关闭规格书还明确了兼容迁移规则Compatibility 一节用户可能在 profiles.json 中遗留布尔值应按true→graceful、false→never映射以实现平滑过渡。当前仓库的实现设置模型中该配置项的声明见 MTSMSettings.hX(CloseOnExitMode, CloseOnExit, closeOnExit, CloseOnExitMode::Automatic)枚举定义见 Profile.idlNever 0, Graceful, Always, Automatic。注意两点与原始规格书的差异属于后续演进的实现事实默认值规格书建议的默认值是graceful而当前默认值为Automatic见 defaults.json 中的closeOnExit: automatic。从TerminalPaneContent.cpp的判断逻辑看automatic在普通 ConPTY 会话下的表现与graceful一致仅在Closed时关闭差异主要体现在 defterm 会话多出的automatic取值用于上面所述的 defterm 移交场景。JSON 解析与布尔兼容 shim 实现在 TerminalSettingsSerializationHelpers.h// - Helper for converting a user-specified closeOnExit value to its corresponding enum JSON_ENUM_MAPPER(::winrt::Microsoft::Terminal::Settings::Model::CloseOnExitMode) { JSON_MAPPINGS(4) { pair_type{ always, ValueType::Always }, pair_type{ graceful, ValueType::Graceful }, pair_type{ never, ValueType::Never }, pair_type{ automatic, ValueType::Automatic }, }; // Override mapping parser to add boolean parsing CloseOnExitMode FromJson(const Json::Value json) { if (json.isBool()) { return json.asBool() ? ValueType::Graceful : ValueType::Never; } return EnumMapper::FromJson(json); } ... };可以看到规格书要求的布尔映射true→Graceful、false→Never被逐字实现。此外未识别的取值会按Automatic解析测试用例中null即落到该分支。单元测试验证DeserializationTests.cpp 中的TestCloseOnExitParsing用例覆盖了字符串取值与null的解析结果{ name: profile0, closeOnExit: graceful } // - CloseOnExitMode::Graceful { name: profile1, closeOnExit: always } // - CloseOnExitMode::Always { name: profile2, closeOnExit: never } // - CloseOnExitMode::Never { name: profile3, closeOnExit: automatic} // - CloseOnExitMode::Automatic { name: profile4, closeOnExit: null } // - CloseOnExitMode::Automatic未知模式解析为 AutomaticTestCloseOnExitCompatibilityShim用例则验证布尔兼容迁移closeOnExit: true解析为GracefulcloseOnExit: false解析为Never与规格书 Compatibility 一节的映射表完全一致。UI/UX 设计终态消息与关闭行为矩阵规格书的 UI/UX 一节要求现有ITerminalConnection实现在进入Closed或Failed状态时应打印有意义、有用的状态信息并以 ConPTY 连接为例场景输出示例状态迁移伪控制台无法打开或进程启动失败[failed to spawn thing: 0x80070002]→Failed进程非预期退出[process exited with code 300]→Failed进程正常退出[process exited with code 0]→Closed规格书强调最后一条消息无论如何都会打印不受用户配置影响。由此得到各配置下的行为矩阵可直接用于对照验证用户配置连接进入Closed连接进入Failednever或旧值false不关闭消息保留在屏幕上不关闭消息保留在屏幕上graceful或旧值true及默认的automatic自动关闭不关闭消息保留在屏幕上供用户查看always自动关闭自动关闭消息来不及被看到这个矩阵与 TerminalPaneContent.cpp 中Always/! Never Closed/Automatic defterm三个判断分支一一对应。能力影响可访问性、可靠性与安全性规格书 Capabilities 一节对改进的影响做了归纳结合实现可以逐条印证可访问性无论用户以何种方式使用终端屏幕阅读器、UI Automation 等都能得知 shell 是启动失败还是以非预期状态码退出——因为终态消息总是会被打印出来可靠性shell 不存在时 Windows Terminal 不再启动即退出窗口会保留并显示失败信息用户有机会修正配置安全性无影响。未来考虑数据绑定、阈值关闭与状态指示规格书 Future considerations 一节给出了三条演进方向其中一条已在代码结构中留有痕迹“仅在 shell 运行超过 X 秒后才按 graceful 规则关闭”——由于状态机能够清晰区分 graceful 与 clumsy 退出该特性在技术上已具备基础规格书甚至给出了{ closeOnExit: 10s }的设想连接状态枚举对需要联网的连接很有用Connecting/Failed等状态对 Azure 等远程连接有直接价值Xaml 数据绑定连接状态通过TerminalControl暴露ConnectionState属性 ConnectionStateChanged事件可以绑定到其他 Xaml 元素上为承载终端控件的面板、标签页提供离散 UI 状态。规格书的例子包括连接已断开的标签页可显示红色边框非激活标签页进入Connected状态时可闪烁提示已就绪。小结closeOnExit的演进是 Windows Terminal 一次典型的“配置项驱动接口重构”案例为了区分进程的“优雅退出”与“失败退出”规格书先为 ITerminalConnection 建立了单向迁移的ConnectionState状态机再把状态经 TerminalControl 的ConnectionStateChanged事件投影到应用层最终由 Pane 依据 profile 的 closeOnExit 配置做出关闭决定。配置层面则通过枚举字符串always/graceful/never/automatic加布尔兼容 shim 的方式平滑迁移了旧设置并有 DeserializationTests.cpp 的单元测试保障解析行为。理解这条“状态机 → 事件投影 → 配置判断”的完整链路是掌握 Windows Terminal 会话生命周期管理的关键。【免费下载链接】terminalThe new Windows Terminal and the original Windows console host, all in the same place!项目地址: https://gitcode.com/GitHub_Trending/term/terminal创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Windows Terminal 中 closeOnExit 配置项与终端连接状态机的演进解析
Windows Terminal 中 closeOnExit 配置项与终端连接状态机的演进解析【免费下载链接】terminalThe new Windows Terminal and the original Windows console host, all in the same place!项目地址: https://gitcode.com/GitHub_Trending/term/terminal本文基于 Windows Terminal 仓库中的设计规格书 Improvements to CloseOnExit讲解closeOnExit配置项从布尔值演进为枚举字符串的完整设计过程以及ITerminalConnection接口为此引入的连接状态机ConnectionState枚举与StateChanged事件。读完后你将理解终端如何区分“正常退出”与“异常失败”两种结束状态、每种closeOnExit取值下的具体关闭行为并能结合仓库源码与单元测试验证这些行为的真实实现。背景为什么需要改进 closeOnExit原始规格书issue #2563作者 Dustin Howett2019 年提出开篇即指出其动机本规格描述了对closeOnExit配置文件特性和ITerminalConnection接口的改进它将提供更大的灵活性并允许我们在面对不可靠软件时给出更合理的默认值。在旧实现中closeOnExit只是一个布尔开关要么“进程退出就关窗口”要么“永不自动关”。这在遇到不可靠软件时暴露出两个问题用户 shell 配置错误比如commandline指向不存在的程序时终端启动即进程立即退出closeOnExit: true会让窗口一闪而过用户根本看不到任何错误提示进程因报错而退出退出码非 0时用户可能希望窗口保留以查看错误输出但布尔值无法区分“正常退出”和“失败退出”。规格书还提到ConEmu 等其他终端模拟器也有类似特性可作为设计参考。解决思路是把“连接是否结束”细化为一个有方向的状态机让应用而非连接本身根据状态与配置共同决定是否关闭面板。ITerminalConnection 接口的状态机设计规格书的核心改动是给ITerminalConnection接口增加了状态枚举和状态迁移事件枚举TerminalConnection::ConnectionState定义为NotConnected所有新连接从该状态开始Connecting连接已发起但尚未完成Connected连接处于活动状态Closing连接正在关闭通常是主动请求Closed连接已关闭可以是主动请求也可以是远端进程成功终止Failed连接被非预期地终止失败。事件StateChanged(ITerminalConnection, IInspectable)IInspectable参数是为类型化事件处理器所必需但不携带有效载荷原有的TerminalDisconnected事件被StateChanged取代而移除规格书明确要求符合规范的实现必须把状态视为有向无环图DAG状态不允许逆向迁移并且可以提供一个辅助类来管理状态迁移。当前仓库中的接口定义与规格书完全一致见 ITerminalConnection.idlenum ConnectionState { NotConnected 0, Connecting, Connected, Closing, Closed, Failed }; interface ITerminalConnection { void Initialize(Windows.Foundation.Collections.ValueSet settings); void Start(); void WriteInput(Char[] data); void Resize(UInt32 rows, UInt32 columns); void Close(); event TerminalOutputHandler TerminalOutput; event Windows.Foundation.TypedEventHandlerITerminalConnection, Object StateChanged; Guid SessionId { get; }; ConnectionState State { get; }; };规格书中提到的“辅助类管理状态迁移”由 BaseTerminalConnection.h 落实基类持有_connectionState成员暴露State()只读访问器和StateChanged类型化事件所有连接实现ConPTY 连接、Azure 连接等通过基类的状态迁移逻辑更新状态并触发StateChanged。TerminalControl 的事件投影规格书规定是否关闭承载连接的面板由应用层决定因此TerminalControl上表达力不足的Close事件被移除替换为ConnectionStateChanged事件同时TerminalControl新增ConnectionState属性直接投影其连接的State规格书注明这是为将来 Xaml 数据绑定预留的见“未来考虑”一节。在应用层这一事件链路的消费方是 TerminalPaneContent.cpp构造函数中通过_setupControlEvents()订阅TerminalControl.ConnectionStateChanged由_controlConnectionStateChangedHandler处理其核心逻辑忠实还原了规格书中的职责划分“Pane 负责根据所承载 profile 的配置做出最终关闭决定”safe_void_coroutine TerminalPaneContent::_controlConnectionStateChangedHandler(...) { ConnectionStateChanged.raise(sender, args); auto newConnectionState ConnectionState::Closed; if (const auto coreState sender.try_asICoreState()) { newConnectionState coreState.ConnectionState(); } const auto previousConnectionState std::exchange(_connectionState, newConnectionState); if (newConnectionState ConnectionState::Closed) { // Pane doesnt care if the connection isnt entering a terminal state. co_return; } ... const auto mode _profile.CloseOnExit(); if ( (mode CloseOnExitMode::Always) || (mode ! CloseOnExitMode::Never newConnectionState ConnectionState::Closed) || (mode CloseOnExitMode::Automatic _isDefTermSession)) { CloseRequested.raise(nullptr, nullptr); } }从源码结构看这里还体现了两条规格书精神的延伸防误闪保护如果连接在从未真正Connected之前就进入Failed例如startingDirectory配错导致进程根本没起来即使配置了closeOnExit: always也不会关闭面板——这正是规格书中 Reliability 一节“Windows Terminal 不再因用户 shell 不存在而在启动时立即终止”的落地Automatic 模式当前实现比规格书原始三值多出一个automatic模式用于 defterm 会话移交handoff等场景保证此类会话即使命令失败也会关闭面板避免 Windows Terminal 窗口被随机拉起源码注释中引用了相关讨论。closeOnExit 配置项取值、默认值与布尔值兼容规格书规定原有的布尔型closeOnExit被替换为支持枚举字符串的键取值行为always承载该 profile 的标签页/面板在连接进入任何终态时总是被关闭graceful仅当连接进入Closed终态正常退出时才关闭Failed时保留never永不自动关闭规格书还明确了兼容迁移规则Compatibility 一节用户可能在 profiles.json 中遗留布尔值应按true→graceful、false→never映射以实现平滑过渡。当前仓库的实现设置模型中该配置项的声明见 MTSMSettings.hX(CloseOnExitMode, CloseOnExit, closeOnExit, CloseOnExitMode::Automatic)枚举定义见 Profile.idlNever 0, Graceful, Always, Automatic。注意两点与原始规格书的差异属于后续演进的实现事实默认值规格书建议的默认值是graceful而当前默认值为Automatic见 defaults.json 中的closeOnExit: automatic。从TerminalPaneContent.cpp的判断逻辑看automatic在普通 ConPTY 会话下的表现与graceful一致仅在Closed时关闭差异主要体现在 defterm 会话多出的automatic取值用于上面所述的 defterm 移交场景。JSON 解析与布尔兼容 shim 实现在 TerminalSettingsSerializationHelpers.h// - Helper for converting a user-specified closeOnExit value to its corresponding enum JSON_ENUM_MAPPER(::winrt::Microsoft::Terminal::Settings::Model::CloseOnExitMode) { JSON_MAPPINGS(4) { pair_type{ always, ValueType::Always }, pair_type{ graceful, ValueType::Graceful }, pair_type{ never, ValueType::Never }, pair_type{ automatic, ValueType::Automatic }, }; // Override mapping parser to add boolean parsing CloseOnExitMode FromJson(const Json::Value json) { if (json.isBool()) { return json.asBool() ? ValueType::Graceful : ValueType::Never; } return EnumMapper::FromJson(json); } ... };可以看到规格书要求的布尔映射true→Graceful、false→Never被逐字实现。此外未识别的取值会按Automatic解析测试用例中null即落到该分支。单元测试验证DeserializationTests.cpp 中的TestCloseOnExitParsing用例覆盖了字符串取值与null的解析结果{ name: profile0, closeOnExit: graceful } // - CloseOnExitMode::Graceful { name: profile1, closeOnExit: always } // - CloseOnExitMode::Always { name: profile2, closeOnExit: never } // - CloseOnExitMode::Never { name: profile3, closeOnExit: automatic} // - CloseOnExitMode::Automatic { name: profile4, closeOnExit: null } // - CloseOnExitMode::Automatic未知模式解析为 AutomaticTestCloseOnExitCompatibilityShim用例则验证布尔兼容迁移closeOnExit: true解析为GracefulcloseOnExit: false解析为Never与规格书 Compatibility 一节的映射表完全一致。UI/UX 设计终态消息与关闭行为矩阵规格书的 UI/UX 一节要求现有ITerminalConnection实现在进入Closed或Failed状态时应打印有意义、有用的状态信息并以 ConPTY 连接为例场景输出示例状态迁移伪控制台无法打开或进程启动失败[failed to spawn thing: 0x80070002]→Failed进程非预期退出[process exited with code 300]→Failed进程正常退出[process exited with code 0]→Closed规格书强调最后一条消息无论如何都会打印不受用户配置影响。由此得到各配置下的行为矩阵可直接用于对照验证用户配置连接进入Closed连接进入Failednever或旧值false不关闭消息保留在屏幕上不关闭消息保留在屏幕上graceful或旧值true及默认的automatic自动关闭不关闭消息保留在屏幕上供用户查看always自动关闭自动关闭消息来不及被看到这个矩阵与 TerminalPaneContent.cpp 中Always/! Never Closed/Automatic defterm三个判断分支一一对应。能力影响可访问性、可靠性与安全性规格书 Capabilities 一节对改进的影响做了归纳结合实现可以逐条印证可访问性无论用户以何种方式使用终端屏幕阅读器、UI Automation 等都能得知 shell 是启动失败还是以非预期状态码退出——因为终态消息总是会被打印出来可靠性shell 不存在时 Windows Terminal 不再启动即退出窗口会保留并显示失败信息用户有机会修正配置安全性无影响。未来考虑数据绑定、阈值关闭与状态指示规格书 Future considerations 一节给出了三条演进方向其中一条已在代码结构中留有痕迹“仅在 shell 运行超过 X 秒后才按 graceful 规则关闭”——由于状态机能够清晰区分 graceful 与 clumsy 退出该特性在技术上已具备基础规格书甚至给出了{ closeOnExit: 10s }的设想连接状态枚举对需要联网的连接很有用Connecting/Failed等状态对 Azure 等远程连接有直接价值Xaml 数据绑定连接状态通过TerminalControl暴露ConnectionState属性 ConnectionStateChanged事件可以绑定到其他 Xaml 元素上为承载终端控件的面板、标签页提供离散 UI 状态。规格书的例子包括连接已断开的标签页可显示红色边框非激活标签页进入Connected状态时可闪烁提示已就绪。小结closeOnExit的演进是 Windows Terminal 一次典型的“配置项驱动接口重构”案例为了区分进程的“优雅退出”与“失败退出”规格书先为 ITerminalConnection 建立了单向迁移的ConnectionState状态机再把状态经 TerminalControl 的ConnectionStateChanged事件投影到应用层最终由 Pane 依据 profile 的 closeOnExit 配置做出关闭决定。配置层面则通过枚举字符串always/graceful/never/automatic加布尔兼容 shim 的方式平滑迁移了旧设置并有 DeserializationTests.cpp 的单元测试保障解析行为。理解这条“状态机 → 事件投影 → 配置判断”的完整链路是掌握 Windows Terminal 会话生命周期管理的关键。【免费下载链接】terminalThe new Windows Terminal and the original Windows console host, all in the same place!项目地址: https://gitcode.com/GitHub_Trending/term/terminal创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
