跳转到主内容

流式渲染 (Beta)

非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →

实验性功能

流式渲染是当前实验性 Beta 功能，正在积极开发中。其行为和配置可能在后续版本中变更。请勿在生产环境中贸然使用。

什么是流式渲染？​

流式渲染是 Oh My Posh 的全新提示符渲染模式，可在片段执行过程中逐步显示提示符。不同于等待所有片段完成后再显示完整提示符，流式模式会立即显示初始提示符，并在数据可用时渐进式更新内容。

工作原理​

在传统渲染模式下，Oh My Posh 的工作流程是：

  1. 执行所有片段（部分片段可能因调用 API、运行命令等操作耗时较长）

  2. 等待所有片段完成

  3. 一次性渲染完整提示符

  4. 显示最终结果

启用流式渲染模式后：

  1. 立即显示包含快速片段的初始提示符

  2. 为加载中的片段显示 ...（可通过片段的 placeholder 属性自定义）

  3. 在慢速片段完成时渐进更新提示符

  4. 使用新数据重新渲染提示符

这种模式能显著提升响应速度，尤其当存在需要获取远程数据或执行耗时操作的片段时。

启用流式渲染​

在配置文件中添加 streaming 属性并设为正整数（表示等待片段的超时时间，单位毫秒）。例如：

{
  "streaming": 100
}
警告

设置过低超时值（如 0 或 50ms）可能导致视觉异常，具体表现取决于终端的渲染能力。建议从 100ms 左右开始调试，再根据实际体验调整。

支持的终端​

当前支持流式渲染的终端：

  • PowerShell (7.2+ 版本)

  • Zsh

  • Fish

未来版本可能增加对其他终端的支持。

反馈渠道​

如遇问题或有改进建议，请在 Oh My Posh GitHub 仓库 提交 issue。