VS Sidebar Terminal

在 VS Code 右侧辅助侧边栏使用独立的 PowerShell 终端，让代码、底部终端和侧边命令窗口同时保持可见。

支持多个终端 Tab、首条命令自动命名、手动重命名，以及隐藏视图后继续运行任务。适合在查看代码的同时运行开发服务、构建命令或命令行工具。

功能

• 右侧终端：默认显示在辅助侧边栏，与 VS Code 内置终端独立使用。
• 多个 Tab：每个 Tab 都有独立的 PowerShell 进程，支持新建、切换和关闭。
• 自动命名：首次提交非空命令后，Tab 自动使用命令名，例如 codex；手动重命名后不会被自动名称覆盖。
• 后台运行：切换 Tab 或隐藏侧边栏时，现有会话继续运行；重新打开后恢复终端画面。
• 复制与粘贴：支持常用快捷键，鼠标选中文字不会自动覆盖剪贴板。
• 跟随编辑器外观：使用 VS Code 主题颜色及终端字体设置。

0.1.9 悬浮提示调整

• 仅移除终端区域的操作提示 title；Tab 和新建/关闭按钮保留原有悬浮提示。

0.1.7 文件跳转优化

• 仅在按住 Ctrl 时识别鼠标所在位置的文件路径，普通移动和拖选不扫描路径。
• 同一个跨行路径复用识别结果；输出、滚动、调整尺寸和切换终端屏幕后清除缓存。

0.1.6 文件跳转

• 支持 Ctrl + 左键点击终端中的文件路径，在 VS Code 编辑器中打开；支持 src/index.ts:12:3 和 src/index.ts#L12C3 定位行列。
• 支持 Windows 绝对路径、相对路径、引号包裹的含空格路径，以及窄侧栏软换行或目录斜杠后的换行。
• 相对路径先从会话当前目录查找，再尝试工作区根目录；PowerShell 执行 cd 后会更新解析目录。

0.1.5 修复

• 自动命名改为读取 PowerShell 最终提交的完整命令，支持右方向键接受预测、Tab 补全和历史命令；不再使用输入前缀猜测名称。
• 未提交或已取消的输入不会命名；手动重命名仍优先，后续命令不会覆盖首条命令名称。
• 运行 codex 等鼠标交互程序时也可直接拖选文本，无需 Shift；滚轮保持正常，按住 Alt 点击或拖动可操作程序。

0.1.4 修复

• 修复鼠标滚轮事件丢失，以及调整窗口、切换 Tab 或隐藏恢复后鼠标编码模式丢失的问题。
• 修正窄侧栏的终端行列尺寸，限制行尾中文预编辑区域，避免输入时横向溢出。

环境要求

• Windows 10 22H2 或 Windows 11，x64 架构。
• VS Code 1.106 或更新版本。
• 本地、受信任的工作区；也可在未打开文件夹的本地窗口中使用。

安装包包含 Windows 原生终端依赖，无需额外安装 Node.js、Python 或 C++ 编译工具。

已在 Windows 11 上进行验证；Windows 10 22H2 和最低 VS Code 版本尚未在独立环境中实测。

安装

在 VS Code 扩展视图中搜索 VS Sidebar Terminal，通过扩展 ID karson1992.vs-sidebar-terminal 确认扩展并安装。

也可以使用命令行安装：

code --install-extension karson1992.vs-sidebar-terminal

如使用离线安装包，在扩展视图的 … 菜单中选择 从 VSIX 安装…，然后选择对应的 .vsix 文件。

快速开始

1. 按 Ctrl+Shift+P 打开命令面板。
2. 执行 VS Sidebar Terminal: 打开侧边终端。
3. 首次打开会创建一个 PowerShell 终端，输入命令后按 Enter 执行。

点击顶部 + 新建终端，点击 Tab 切换，点击 × 关闭对应会话。双击 Tab 名称可重命名，也可以聚焦 Tab 后按 F2。

关闭会话会结束对应进程及其附属进程，请先保存运行中程序的工作。全部关闭后显示“新建终端”按钮，不会自动创建新进程。

进程自然退出后，Tab 与输出会保留，并显示退出码；系统未提供退出码时显示“未知”。

快捷键

运行 codex 等启用鼠标交互的终端程序后，可直接拖动选中文字，再按 Ctrl+Shift+C 复制。需要点击程序里的控件时，按住 Alt 操作；滚轮仍交给程序处理，鼠标选择本身不会自动复制。

命令面板

以下命令均以 VS Sidebar Terminal: 为前缀：

PowerShell 与工作目录

优先使用 PATH 中的 PowerShell 7，再查找标准安装目录；未找到时使用系统自带的 Windows PowerShell。

启动时加载正常的 PowerShell 配置文件。工作目录为工作区的第一个文件夹；未打开文件夹时使用当前用户目录。命令以 VS Code 当前用户的权限执行。

自动命名通过会话内的 PSReadLine 读行钩子获取已提交命令，不修改用户配置文件。若用户在会话中移除 PSReadLine 或替换读行函数，自动命名可能不可用，仍可手动重命名。

资源使用与限制

扩展按需创建终端，只渲染当前 Tab。隐藏视图时释放页面，后台保留会话及有限的屏幕状态；每个 Tab 最多保留 1,000 行滚动历史，较早输出会被淘汰。

每个会话的 PowerShell 进程仍会占用资源，其用量取决于加载的模块和运行的命令。多个会话不需要继续使用时，可以关闭对应 Tab。

• 当前仅支持 Windows x64 的本地环境，不支持 WSL、SSH、容器或浏览器版 VS Code。
• 不支持分屏和跨重启恢复；关闭或重载 VS Code 后不会恢复此前会话。
• 真实中文输入法候选窗交互仍需在使用者桌面进一步验证。

若曾手动移动终端视图，VS Code 会记住该位置；可通过视图标题上的菜单或拖动标题调整位置。

许可证

MIT License。第三方依赖的许可证见随扩展分发的 THIRD_PARTY_NOTICES.md。