Zed 内置终端完全指南多实例、自定义 Shell 与编辑器深度集成【免费下载链接】zedCode at the speed of thought – Zed is a high-performance, multiplayer code editor from the creators of Atom and Tree-sitter.项目地址: https://gitcode.com/GitHub_Trending/ze/zedZed 内置了一个功能完整的终端仿真器支持多终端实例、自定义 Shell、Python 虚拟环境自动激活以及与编辑器、任务系统和 AI 助手的深度联动。本文以官方文档 docs/src/terminal.md 为核心结合仓库中的终端设置定义、默认配置与默认键位源码系统讲解如何在 Zed 中配置终端以获得接近独立终端应用的使用体验。终端概览与设置入口在 Zed 中所有终端相关选项都集中放在用户设置文件settings.json的terminal键下。终端设置由 crates/terminal/src/terminal_settings.rs 中的TerminalSettings结构体统一承载字段涵盖 Shell、工作目录、环境变量、字体、光标、滚动、面板、最小对比度、路径超链接等多个维度。一个值得注意的实现细节是部分终端设置可以写在项目级设置.zed/settings.json中随项目分发。从 crates/terminal/src/terminal_settings.rs 可以看到终端设置被拆成了用户层与项目层两层其中shell、working_directory、env、detect_venv、path_hyperlink_regexes、path_hyperlink_timeout_ms属于项目层适合固化在仓库中让团队共享而字体、光标等外观类选项属于用户层。这一点在后面的配置示例中会反复用到。打开终端快捷键操作macOSLinux/Windows切换开关终端面板CtrlCtrl打开新终端Ctrl~Ctrl~在中央Center打开终端命令面板命令面板这些快捷键并非写死的逻辑而是直接对应 Zed 内置动作。例如在 assets/keymaps/default-linux.json 中可以看到全局绑定ctrl-~: workspace::NewTerminal、ctrl-: terminal_panel::Toggle。你也可以随时打开命令面板macOS 为CmdShiftP搜索以下动作执行terminal_panel::Toggle—— 切换终端面板的显示/隐藏workspace::NewTerminal—— 新建一个终端workspace::NewCenterTerminal—— 在中央区域新建终端对应编辑器内动作定义见 crates/terminal_view/src/terminal_view.rs。终端面板Terminal Panel与中央终端Center Terminal终端可以出现在两个位置终端面板Terminal Panel默认停靠在工作区底部也可以停靠左侧或右侧。用Ctrl一键开关。中央窗格Center Pane作为一个普通标签页与文件标签并列打开。通过命令面板执行workspace::NewCenterTerminal即可。二者的取舍很直观面板型终端不占用文件编辑区适合常驻后台的任务如 dev server、git 操作中央终端与代码同屏同栏适合对照源码查看运行结果。Zed 在终端面板右键菜单中也直接提供了New Terminal、New Center Terminal等入口参见 crates/terminal_view/src/terminal_view.rs。多终端工作流Zed 不限制终端数量你可以像管理编辑器标签页一样管理多个终端实例新建终端焦点在终端面板内时按CmdNmacOS或CtrlNLinux/Windows。在 macOS 默认键位中cmd-n在Terminal上下文里确实被绑定为workspace::NewTerminal见 assets/keymaps/default-macos.json。每个新终端会作为面板里的一个标签页出现随时在标签间切换。分割终端CmdDmacOS或CtrlShift5Linux/Windows将当前终端纵向分割为左右两个窗格。对应键位在源码中分别为cmd-d与ctrl-shift-5且都指向pane::SplitRight见 assets/keymaps/default-linux.json 与 assets/keymaps/default-macos.json。多实例配合每个任务一个终端的习惯可以彻底告别在单个终端里反复切换目录的低效操作。配置 Shell默认行为与可选形态默认情况下Zed 使用系统默认 Shell——在 Unix 系统上即读取/etc/passwd中为当前用户配置的 ShellWindows 上则使用系统默认终端配置。对应源码 crates/settings_content/src/terminal.rs 中的Shell枚举支持三种形态system—— 使用系统默认 Shell{ program: ... }—— 指定一个不带参数的程序{ with_arguments: { program: ..., args: [...] } }—— 指定带参数的程序额外支持可选的title_override字段来覆盖终端标签页标题。指定 Shell要改用其他 Shell写入{ terminal: { shell: { program: /bin/zsh } } }携带参数启动 Shellshell: system这种字符串简写无法传参如需传参则要使用with_arguments结构。例如以登录 Shell 方式启动 bash{ terminal: { shell: { with_arguments: { program: /bin/bash, args: [--login] } } } }title_override字段在 crates/settings_content/src/terminal.rs 中定义可用于固定终端标签标题而后续小节会提到标题也可以由 Shell 通过 OSC 转义序列动态设置title_override属于更硬的静态覆盖。注意shell属于项目层设置因此这段配置放在项目根目录.zed/settings.json中即可做到进入项目即用指定 Shell。控制终端起始目录Working Directory新终端的初始目录由working_directory控制共有五种取值见 crates/settings_content/src/terminal.rs 中WorkingDirectory枚举的定义取值行为current_file_directory使用当前文件的所在目录若失败则回退到项目目录再回退到工作区中第一个项目current_project_directory使用当前文件所属项目的根目录默认值first_project_directory使用工作区中第一个项目的根目录失败时回退到 home 目录always_home始终从 home 目录启动{ always: { directory: ~/projects } }始终从指定目录启动路径会做 Shell 展开若目录无效则回退到 home 目录配置示例{ terminal: { working_directory: first_project_directory } }其中默认值为current_project_directory这一默认也在 assets/settings/default.json 中得到印证。多项目Multi-root工作区用户可能更希望用first_project_directory获得确定性的起始位置。终端环境变量env接受一组键值对会被注入到所有由 Zed 启动的终端会话中{ terminal: { env: { EDITOR: zed --wait, MY_VAR: value } } }一个非常实用的做法是把EDITOR指回 Zed 自身配合zed --wait可以让 git 等工具阻塞等待编辑完成后继续执行。需要注意的语法细节提示当同一变量需要多个值时使用:分隔例如PATH: /custom/path:$PATH。这是因为 Zed 追加环境变量时依赖:分隔符来拼接路径类变量见 crates/settings_content/src/terminal.rs 对env的说明。同样地env属于项目层设置写入.zed/settings.json可让同仓库的协作者共享一致的PATH、RUST_BACKTRACE之类的环境。Python 虚拟环境自动激活Zed 可以在打开终端时自动探测并激活 Python 虚拟环境省去手动source .venv/bin/activate的步骤。默认情况下它会基于由working_directory解析出的当前工作目录依次搜索名为.env、env、.venv、venv的目录相关默认值记录在 assets/settings/default.json。自定义探测目录与激活脚本{ terminal: { detect_venv: { on: { directories: [.venv, venv], activate_script: default } } } }其中activate_script的可选值源码见 crates/settings_content/src/terminal.rs 的ActivateScript枚举包括default—— 标准 POSIX 激活脚本默认csh—— C shell 风格fish—— fish shell 风格nushell—— Nushell 风格power_shell—— PowerShell 风格pyenv—— 使用 pyenv。此外crates/settings_content/src/terminal.rs 中的VenvSettings还支持conda_manager字段取值auto/conda/mamba/micromamba默认auto用于激活 Conda 环境。建议源码注释明确建议在项目设置中覆盖directories列表而不是在全局设置里配置因为虚拟环境目录通常是项目级的约定。关闭虚拟环境探测{ terminal: { detect_venv: off } }字体与外观终端的排版可以与编辑器字体相互独立。例如{ terminal: { font_family: JetBrains Mono, font_size: 14, font_features: { calt: false }, line_height: comfortable } }font_size/font_family若未设置终端默认跟随编辑器缓冲区的字体与字号见 crates/settings_content/src/terminal.rs。同时还有font_fallbacks字体回退列表会与平台默认回退合并与font_weightCSS 字重 100–900默认 400两个可选字段。font_features用于开关 OpenType 特性例如上例关闭了calt上下文连字。行高Line Height行高配置的取值如下定义见 crates/settings_content/src/terminal.rs取值说明comfortable1.618 行高比接近黄金比例适合长时间阅读输出standard1.3 行高比更适合 vim、htop 等大量绘制盒式边框字符的 TUI 程序{ custom: 1.5 }自定义比例任意浮点值会被钳制在 ≥ 1.0需要留意文档与 Rust 枚举层面标记的默认值为comfortable1.618而仓库自带默认配置 assets/settings/default.json 中实际写的是standard1.3。如果你主要跑 TUI 工具standard是更稳妥的选择如果你看重阅读体验可显式切回comfortable或使用custom精确调校。光标Cursor{ terminal: { cursor_shape: bar, blinking: on } }cursor_shape可选block块状默认、bar竖线、underline下划线、hollow空心方块语义注释见 crates/terminal/src/terminal_settings.rs。blinking可选off从不闪烁、terminal_controlled默认交由终端程序决定是否开启闪烁、on始终闪烁对应 crates/settings_content/src/terminal.rs。最小对比度Minimum Contrast部分深色终端主题下前景色与背景色对比不足会影响可读性。Zed 会自动微调终端颜色以维持可读性调节强度由minimum_contrast控制{ terminal: { minimum_contrast: 0 } }该值基于 APCA可感知对比度算法计算取值范围 0–106默认 45保证在色彩丰富与可读性之间取得平衡0—— 不做任何对比度调整完全使用主题原始颜色45—— 默认值适合大号流畅文本36px的阅读下限大多数终端主题的 APCA 值落在 40–70 之间60/75/90—— 分别对应普通内容文本、正文的最小值与推荐值。详见 crates/settings_content/src/terminal.rs。如果你使用精确校色的主题、希望所见即所得可设为0关闭该机制。滚动浏览历史输出终端输出超出可视区域后可以用以下键位浏览回滚历史操作macOSLinux/Windows向上翻页ShiftPageUp或CmdUpShiftPageUp向下翻页ShiftPageDown或CmdDownShiftPageDown向上滚一行ShiftUpShiftUp向下滚一行ShiftDownShiftDown滚到顶部ShiftHome或CmdHomeShiftHome滚到底部ShiftEnd或CmdEndShiftEnd这些动作在默认键位中一一对应terminal::ScrollPageUp、terminal::ScrollLineUp、terminal::ScrollToTop等例如 assets/keymaps/default-linux.json。此外还有两项与滚动相关的深度配置滚轮速度倍率{ terminal: { scroll_multiplier: 3.0 } }默认值为1.0见 assets/settings/default.json调大后滚轮单次滚动翻过的行数更多。回滚缓冲行数上限{ terminal: { max_scroll_history_lines: 10000 } }默认10_000行上限100_000超出的值一律按上限处理0表示完全禁用滚动历史。注意源码注释指出该项变更不会作用于已存在的终端需要重新创建终端后生效见 crates/settings_content/src/terminal.rs。复制与粘贴操作macOSLinux/Windows复制CmdCCtrlShiftC粘贴CmdVCtrlShiftV对应关系同样可在默认键位中验证macOS 的Terminal上下文中cmd-c→terminal::Copy、cmd-v→terminal::Paste见 assets/keymaps/default-macos.jsonLinux 下ctrl-shift-c→terminal::Copy、ctrl-shift-v→terminal::Paste另支持ctrl-insert、shift-insert见 assets/keymaps/default-linux.json。之所以 Linux 不用裸CtrlC是因为该组合键需留给 Shell 的 SIGINT 中断信号。选中即复制Copy on Select{ terminal: { copy_on_select: true } }开启后用鼠标选中文本就会自动写入系统剪贴板。默认值为false。复制后保留选区Keep Selection on Copy默认情况下执行复制后文本会保持选中便于连续操作{ terminal: { keep_selection_on_copy: false } }若希望复制完成后立即清除选区将该值设为false即可默认true见 assets/settings/default.json。终端内搜索按CmdFmacOS或CtrlShiftFLinux/Windows即可在终端中搜索历史输出。它打开的正是编辑器里同款的面板式搜索栏键位绑定到buffer_search::Deploy见 assets/keymaps/default-linux.json支持高亮匹配、增量跳转等一致体验。Vi 模式终端内也内置了 Vi 风格的导航模式切换键CtrlShiftSpace对应动作terminal::ToggleViMode。开启后即可使用h/j/k/l、w/b、0/$等 Vi 键位移动光标并按词、按行选中文本再配合复制快捷键把内容取回编辑器。macOS 用户注意CtrlShiftSpace默认被系统占用为选择上一个输入源。若按键无效需要在 macOS「系统设置 → 键盘 → 键盘快捷键 → 输入法」中取消勾选该项后重启 Zed。这一提示在 assets/keymaps/default-macos.json 的键位注释中有明确说明。清屏macOSCmdKLinux/WindowsCtrlShiftL两个组合键分别对应terminal::Clear其中 Linux 侧的绑定见 assets/keymaps/default-linux.json。Option 键作为 MetamacOS对 Emacs 用户或依赖 Meta 组合键如AltX的应用可以把 macOS 的 Option 键重新解释为 Meta{ terminal: { option_as_meta: true } }默认值为false此时 Option 键会沿用 macOS 平台行为配合其他键生成某些 Unicode 字符设为true后Alt开头的经典 Meta 序列如 Emacs 的M-x、shell 里的AltB/AltF按词移动将正确送达终端。两种语义的对比在 assets/settings/default.json 有详细注释。交替滚动模式Alternate Scroll在 vim、less、htop 等进入备用屏幕alternate screen的全屏 TUI 应用里滚轮滚动默认并不生效。Zed 支持将滚轮事件转换为上/下方向键{ terminal: { alternate_scroll: on } }on—— 默认值。在备用屏幕中把滚轮滚动翻译成Up/Down按键滚轮即可在 vim 里翻页、在 less 里滚动文档。off—— 关闭该转换。从源码看该设置对应 DEC 模式?1007Alternate Scroll且终端应用仍可运行时自行开启或关闭此模式设置项只决定初始状态见 crates/settings_content/src/terminal.rs。路径超链接Path HyperlinksZed 会实时识别终端输出中的文件路径并让其可点击。CmdClickmacOS或CtrlClickLinux/Windows会在 Zed 中打开该文件若能识别到行号还会直接跳转。常见可识别格式包括src/main.rs:42—— 在第 42 行打开src/main.rs:42:10—— 在第 42 行第 10 列打开File script.py, line 10—— Python traceback。鼠标上报模式下的点击行为许多应用开启后会自己接管鼠标如vim设置mousea、htop。默认情况下即使应用启用了鼠标上报CmdClick/CtrlClick依然优先打开路径链接。如果你希望这类点击被转发给应用本身例如触发 vim 的光标定位可以关闭该行为{ terminal: { open_links_in_mouse_mode: false } }关闭后应用接管鼠标时打开链接的方式变为ShiftCmdClickmacOS或ShiftCtrlClickLinux/Windows。该默认值true同样记录在 assets/settings/default.json。自定义路径识别规则路径识别不是写死的正则而是可扩展的path_hyperlink_regexes配置见 assets/settings/default.json。规则支持命名捕获组path跳转目标路径、line、column、link指定终端里哪些文本被划为链接。默认内置两条规则Python 风格诊断File (?path[^]), line (?line[0-9])通用路径 可选行/列语法兼容引号包裹、行列为line:column与(line,column)两种写法。处理逻辑会停在第一个命中的正则因此注释建议把命中率高的规则排在前面以优化性能。同时还有path_hyperlink_timeout_ms默认1ms设为0会完全禁用路径超链接用于约束悬停/点击时做超链接探测的耗时预算。终端面板配置停靠位置Dock{ terminal: { dock: bottom } }可选值bottom默认见 assets/settings/default.json、left、right对应源码中的TerminalDockPosition枚举crates/settings_content/src/terminal.rs。默认尺寸{ terminal: { default_width: 640, default_height: 320 } }default_width停靠在左/右时的默认宽度默认640default_height停靠在底部时的默认高度默认320。与之相关的还有两个面板行为字段starts_open是否随启动自动展开终端面板默认false与flexible面板是否采用与编辑器成比例proportional的伸缩布局默认true。状态栏终端按钮终端面板图标默认显示在状态栏。隐藏方式{ terminal: { button: false } }若喜欢用快捷键或命令面板开关终端可以把它关掉以节省状态栏空间默认true。顺带一提还有一个show_count_badge选项可在终端面板图标上显示当前打开的终端数量角标默认false。工具栏与动态标题在终端窗格顶部的工具栏面包屑显示终端标题{ terminal: { toolbar: { breadcrumbs: true } } }标题可以由运行中的 Shell 通过 OSC 转义序列动态写入格式为\e]2;Title\007。例如在 bash 中执行echo -e \e]2;New Title\007即可把当前终端标签重命名为New Title参见 crates/settings_content/src/terminal.rs 中TerminalToolbarContent的说明。日常可让.bashrc/.zshrc在进入特定目录时发一条这样的序列标签页标题就会随上下文变化。滚动条与提示音补充项终端滚动条默认继承编辑器的滚动条设置terminal.scrollbar.show可显式指定auto/system/always/never见 crates/settings_content/src/terminal.rs。terminal.bell控制收到BEL字符\a时的行为system播放系统提示音、off静默。仓库默认配置 assets/settings/default.json 中为off。与任务系统Tasks的集成终端与 Zed 的任务系统天然打通当你运行一个任务Task时它会在终端中执行命令输出与手动输入的命令出现在同一视图里。更多任务定义见 Tasks 文档。在终端内可以快速重跑上一个任务macOSCmdAltRLinux/WindowsCtrlShiftR或AltT这些键位在默认配置中都绑定到terminal::RerunTask。例如 Linux 侧assets/keymaps/default-linux.json同时提供了ctrl-shift-r、ctrl-alt-r、alt-t三种等价触发方式。反复调试编辑 → 重跑 → 看输出的循环时非常顺手。AI 助手联动终端的报错信息可以一键交给内联助手解释macOSCtrlEnterLinux/WindowsCtrlEnter或CtrlI这会唤起 Inline Assistant用于解释报错原因、给出修复建议或直接建议可执行的命令键位对应动作assistant::InlineAssist见 assets/keymaps/default-macos.json。Zed 还为终端场景准备了专用的助手提示模板 assets/prompts/terminal_assistant_prompt.hbs让助手理解终端语义、给出贴合上下文的输出。详见 Inline Assistant 文档。更进一步Agent Panel 中的 AI Agent 可以在自己的工作流中直接执行终端命令——这意味着让 Agent 修完代码后顺手跑一遍测试并解读输出可以成为完整的闭环体验。向终端发送文本与按键对于高级键位定制Zed 提供了两个注入型动作可以把任意按键序列交给终端处理terminal::SendText—— 把一段原始文本写入终端支持\u001b这类转义适合发送 ESC 引导的序列terminal::SendKeystroke—— 模拟发送一次按键按键名采用 Zed 键位语法。自定义示例{ context: Terminal, bindings: { alt-left: [terminal::SendText, \u001bb], ctrl-c: [terminal::SendKeystroke, ctrl-c] } }这里的\u001bb即ESC b在 Readline 系 Shell 中表示光标向左跳一个词。事实上 Zed 的默认键位就是大量借助这两个动作实现的——例如 macOS 下alt-left→SendText \u001bb、cmd-left→SendKeystroke ctrl-a、cmd-backspace→SendKeystroke ctrl-u清空整行见 assets/keymaps/default-macos.json。以此为基础你可以为自己的工作流设计高度定制的一键宏。编辑键位文件的方式是通过命令面板执行zed::OpenKeymap或CmdK CmdS。完整设置参考上文只覆盖了最常用的终端配置。完整的terminal配置项清单含每个字段的默认值与取值范围可在 All Settings 文档的 Terminal 一节 查看也可以直接阅读仓库中的默认配置文件 assets/settings/default.json它本身就是一份带详细注释的最佳说明书。下一步Tasks —— 在 Zed 中定义并运行命令与脚本REPL —— 交互式代码执行CLI 参考 —— 用命令行在 Zed 中打开文件与目录。【免费下载链接】zedCode at the speed of thought – Zed is a high-performance, multiplayer code editor from the creators of Atom and Tree-sitter.项目地址: https://gitcode.com/GitHub_Trending/ze/zed创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Zed 内置终端完全指南：多实例、自定义 Shell 与编辑器深度集成
Zed 内置终端完全指南多实例、自定义 Shell 与编辑器深度集成【免费下载链接】zedCode at the speed of thought – Zed is a high-performance, multiplayer code editor from the creators of Atom and Tree-sitter.项目地址: https://gitcode.com/GitHub_Trending/ze/zedZed 内置了一个功能完整的终端仿真器支持多终端实例、自定义 Shell、Python 虚拟环境自动激活以及与编辑器、任务系统和 AI 助手的深度联动。本文以官方文档 docs/src/terminal.md 为核心结合仓库中的终端设置定义、默认配置与默认键位源码系统讲解如何在 Zed 中配置终端以获得接近独立终端应用的使用体验。终端概览与设置入口在 Zed 中所有终端相关选项都集中放在用户设置文件settings.json的terminal键下。终端设置由 crates/terminal/src/terminal_settings.rs 中的TerminalSettings结构体统一承载字段涵盖 Shell、工作目录、环境变量、字体、光标、滚动、面板、最小对比度、路径超链接等多个维度。一个值得注意的实现细节是部分终端设置可以写在项目级设置.zed/settings.json中随项目分发。从 crates/terminal/src/terminal_settings.rs 可以看到终端设置被拆成了用户层与项目层两层其中shell、working_directory、env、detect_venv、path_hyperlink_regexes、path_hyperlink_timeout_ms属于项目层适合固化在仓库中让团队共享而字体、光标等外观类选项属于用户层。这一点在后面的配置示例中会反复用到。打开终端快捷键操作macOSLinux/Windows切换开关终端面板CtrlCtrl打开新终端Ctrl~Ctrl~在中央Center打开终端命令面板命令面板这些快捷键并非写死的逻辑而是直接对应 Zed 内置动作。例如在 assets/keymaps/default-linux.json 中可以看到全局绑定ctrl-~: workspace::NewTerminal、ctrl-: terminal_panel::Toggle。你也可以随时打开命令面板macOS 为CmdShiftP搜索以下动作执行terminal_panel::Toggle—— 切换终端面板的显示/隐藏workspace::NewTerminal—— 新建一个终端workspace::NewCenterTerminal—— 在中央区域新建终端对应编辑器内动作定义见 crates/terminal_view/src/terminal_view.rs。终端面板Terminal Panel与中央终端Center Terminal终端可以出现在两个位置终端面板Terminal Panel默认停靠在工作区底部也可以停靠左侧或右侧。用Ctrl一键开关。中央窗格Center Pane作为一个普通标签页与文件标签并列打开。通过命令面板执行workspace::NewCenterTerminal即可。二者的取舍很直观面板型终端不占用文件编辑区适合常驻后台的任务如 dev server、git 操作中央终端与代码同屏同栏适合对照源码查看运行结果。Zed 在终端面板右键菜单中也直接提供了New Terminal、New Center Terminal等入口参见 crates/terminal_view/src/terminal_view.rs。多终端工作流Zed 不限制终端数量你可以像管理编辑器标签页一样管理多个终端实例新建终端焦点在终端面板内时按CmdNmacOS或CtrlNLinux/Windows。在 macOS 默认键位中cmd-n在Terminal上下文里确实被绑定为workspace::NewTerminal见 assets/keymaps/default-macos.json。每个新终端会作为面板里的一个标签页出现随时在标签间切换。分割终端CmdDmacOS或CtrlShift5Linux/Windows将当前终端纵向分割为左右两个窗格。对应键位在源码中分别为cmd-d与ctrl-shift-5且都指向pane::SplitRight见 assets/keymaps/default-linux.json 与 assets/keymaps/default-macos.json。多实例配合每个任务一个终端的习惯可以彻底告别在单个终端里反复切换目录的低效操作。配置 Shell默认行为与可选形态默认情况下Zed 使用系统默认 Shell——在 Unix 系统上即读取/etc/passwd中为当前用户配置的 ShellWindows 上则使用系统默认终端配置。对应源码 crates/settings_content/src/terminal.rs 中的Shell枚举支持三种形态system—— 使用系统默认 Shell{ program: ... }—— 指定一个不带参数的程序{ with_arguments: { program: ..., args: [...] } }—— 指定带参数的程序额外支持可选的title_override字段来覆盖终端标签页标题。指定 Shell要改用其他 Shell写入{ terminal: { shell: { program: /bin/zsh } } }携带参数启动 Shellshell: system这种字符串简写无法传参如需传参则要使用with_arguments结构。例如以登录 Shell 方式启动 bash{ terminal: { shell: { with_arguments: { program: /bin/bash, args: [--login] } } } }title_override字段在 crates/settings_content/src/terminal.rs 中定义可用于固定终端标签标题而后续小节会提到标题也可以由 Shell 通过 OSC 转义序列动态设置title_override属于更硬的静态覆盖。注意shell属于项目层设置因此这段配置放在项目根目录.zed/settings.json中即可做到进入项目即用指定 Shell。控制终端起始目录Working Directory新终端的初始目录由working_directory控制共有五种取值见 crates/settings_content/src/terminal.rs 中WorkingDirectory枚举的定义取值行为current_file_directory使用当前文件的所在目录若失败则回退到项目目录再回退到工作区中第一个项目current_project_directory使用当前文件所属项目的根目录默认值first_project_directory使用工作区中第一个项目的根目录失败时回退到 home 目录always_home始终从 home 目录启动{ always: { directory: ~/projects } }始终从指定目录启动路径会做 Shell 展开若目录无效则回退到 home 目录配置示例{ terminal: { working_directory: first_project_directory } }其中默认值为current_project_directory这一默认也在 assets/settings/default.json 中得到印证。多项目Multi-root工作区用户可能更希望用first_project_directory获得确定性的起始位置。终端环境变量env接受一组键值对会被注入到所有由 Zed 启动的终端会话中{ terminal: { env: { EDITOR: zed --wait, MY_VAR: value } } }一个非常实用的做法是把EDITOR指回 Zed 自身配合zed --wait可以让 git 等工具阻塞等待编辑完成后继续执行。需要注意的语法细节提示当同一变量需要多个值时使用:分隔例如PATH: /custom/path:$PATH。这是因为 Zed 追加环境变量时依赖:分隔符来拼接路径类变量见 crates/settings_content/src/terminal.rs 对env的说明。同样地env属于项目层设置写入.zed/settings.json可让同仓库的协作者共享一致的PATH、RUST_BACKTRACE之类的环境。Python 虚拟环境自动激活Zed 可以在打开终端时自动探测并激活 Python 虚拟环境省去手动source .venv/bin/activate的步骤。默认情况下它会基于由working_directory解析出的当前工作目录依次搜索名为.env、env、.venv、venv的目录相关默认值记录在 assets/settings/default.json。自定义探测目录与激活脚本{ terminal: { detect_venv: { on: { directories: [.venv, venv], activate_script: default } } } }其中activate_script的可选值源码见 crates/settings_content/src/terminal.rs 的ActivateScript枚举包括default—— 标准 POSIX 激活脚本默认csh—— C shell 风格fish—— fish shell 风格nushell—— Nushell 风格power_shell—— PowerShell 风格pyenv—— 使用 pyenv。此外crates/settings_content/src/terminal.rs 中的VenvSettings还支持conda_manager字段取值auto/conda/mamba/micromamba默认auto用于激活 Conda 环境。建议源码注释明确建议在项目设置中覆盖directories列表而不是在全局设置里配置因为虚拟环境目录通常是项目级的约定。关闭虚拟环境探测{ terminal: { detect_venv: off } }字体与外观终端的排版可以与编辑器字体相互独立。例如{ terminal: { font_family: JetBrains Mono, font_size: 14, font_features: { calt: false }, line_height: comfortable } }font_size/font_family若未设置终端默认跟随编辑器缓冲区的字体与字号见 crates/settings_content/src/terminal.rs。同时还有font_fallbacks字体回退列表会与平台默认回退合并与font_weightCSS 字重 100–900默认 400两个可选字段。font_features用于开关 OpenType 特性例如上例关闭了calt上下文连字。行高Line Height行高配置的取值如下定义见 crates/settings_content/src/terminal.rs取值说明comfortable1.618 行高比接近黄金比例适合长时间阅读输出standard1.3 行高比更适合 vim、htop 等大量绘制盒式边框字符的 TUI 程序{ custom: 1.5 }自定义比例任意浮点值会被钳制在 ≥ 1.0需要留意文档与 Rust 枚举层面标记的默认值为comfortable1.618而仓库自带默认配置 assets/settings/default.json 中实际写的是standard1.3。如果你主要跑 TUI 工具standard是更稳妥的选择如果你看重阅读体验可显式切回comfortable或使用custom精确调校。光标Cursor{ terminal: { cursor_shape: bar, blinking: on } }cursor_shape可选block块状默认、bar竖线、underline下划线、hollow空心方块语义注释见 crates/terminal/src/terminal_settings.rs。blinking可选off从不闪烁、terminal_controlled默认交由终端程序决定是否开启闪烁、on始终闪烁对应 crates/settings_content/src/terminal.rs。最小对比度Minimum Contrast部分深色终端主题下前景色与背景色对比不足会影响可读性。Zed 会自动微调终端颜色以维持可读性调节强度由minimum_contrast控制{ terminal: { minimum_contrast: 0 } }该值基于 APCA可感知对比度算法计算取值范围 0–106默认 45保证在色彩丰富与可读性之间取得平衡0—— 不做任何对比度调整完全使用主题原始颜色45—— 默认值适合大号流畅文本36px的阅读下限大多数终端主题的 APCA 值落在 40–70 之间60/75/90—— 分别对应普通内容文本、正文的最小值与推荐值。详见 crates/settings_content/src/terminal.rs。如果你使用精确校色的主题、希望所见即所得可设为0关闭该机制。滚动浏览历史输出终端输出超出可视区域后可以用以下键位浏览回滚历史操作macOSLinux/Windows向上翻页ShiftPageUp或CmdUpShiftPageUp向下翻页ShiftPageDown或CmdDownShiftPageDown向上滚一行ShiftUpShiftUp向下滚一行ShiftDownShiftDown滚到顶部ShiftHome或CmdHomeShiftHome滚到底部ShiftEnd或CmdEndShiftEnd这些动作在默认键位中一一对应terminal::ScrollPageUp、terminal::ScrollLineUp、terminal::ScrollToTop等例如 assets/keymaps/default-linux.json。此外还有两项与滚动相关的深度配置滚轮速度倍率{ terminal: { scroll_multiplier: 3.0 } }默认值为1.0见 assets/settings/default.json调大后滚轮单次滚动翻过的行数更多。回滚缓冲行数上限{ terminal: { max_scroll_history_lines: 10000 } }默认10_000行上限100_000超出的值一律按上限处理0表示完全禁用滚动历史。注意源码注释指出该项变更不会作用于已存在的终端需要重新创建终端后生效见 crates/settings_content/src/terminal.rs。复制与粘贴操作macOSLinux/Windows复制CmdCCtrlShiftC粘贴CmdVCtrlShiftV对应关系同样可在默认键位中验证macOS 的Terminal上下文中cmd-c→terminal::Copy、cmd-v→terminal::Paste见 assets/keymaps/default-macos.jsonLinux 下ctrl-shift-c→terminal::Copy、ctrl-shift-v→terminal::Paste另支持ctrl-insert、shift-insert见 assets/keymaps/default-linux.json。之所以 Linux 不用裸CtrlC是因为该组合键需留给 Shell 的 SIGINT 中断信号。选中即复制Copy on Select{ terminal: { copy_on_select: true } }开启后用鼠标选中文本就会自动写入系统剪贴板。默认值为false。复制后保留选区Keep Selection on Copy默认情况下执行复制后文本会保持选中便于连续操作{ terminal: { keep_selection_on_copy: false } }若希望复制完成后立即清除选区将该值设为false即可默认true见 assets/settings/default.json。终端内搜索按CmdFmacOS或CtrlShiftFLinux/Windows即可在终端中搜索历史输出。它打开的正是编辑器里同款的面板式搜索栏键位绑定到buffer_search::Deploy见 assets/keymaps/default-linux.json支持高亮匹配、增量跳转等一致体验。Vi 模式终端内也内置了 Vi 风格的导航模式切换键CtrlShiftSpace对应动作terminal::ToggleViMode。开启后即可使用h/j/k/l、w/b、0/$等 Vi 键位移动光标并按词、按行选中文本再配合复制快捷键把内容取回编辑器。macOS 用户注意CtrlShiftSpace默认被系统占用为选择上一个输入源。若按键无效需要在 macOS「系统设置 → 键盘 → 键盘快捷键 → 输入法」中取消勾选该项后重启 Zed。这一提示在 assets/keymaps/default-macos.json 的键位注释中有明确说明。清屏macOSCmdKLinux/WindowsCtrlShiftL两个组合键分别对应terminal::Clear其中 Linux 侧的绑定见 assets/keymaps/default-linux.json。Option 键作为 MetamacOS对 Emacs 用户或依赖 Meta 组合键如AltX的应用可以把 macOS 的 Option 键重新解释为 Meta{ terminal: { option_as_meta: true } }默认值为false此时 Option 键会沿用 macOS 平台行为配合其他键生成某些 Unicode 字符设为true后Alt开头的经典 Meta 序列如 Emacs 的M-x、shell 里的AltB/AltF按词移动将正确送达终端。两种语义的对比在 assets/settings/default.json 有详细注释。交替滚动模式Alternate Scroll在 vim、less、htop 等进入备用屏幕alternate screen的全屏 TUI 应用里滚轮滚动默认并不生效。Zed 支持将滚轮事件转换为上/下方向键{ terminal: { alternate_scroll: on } }on—— 默认值。在备用屏幕中把滚轮滚动翻译成Up/Down按键滚轮即可在 vim 里翻页、在 less 里滚动文档。off—— 关闭该转换。从源码看该设置对应 DEC 模式?1007Alternate Scroll且终端应用仍可运行时自行开启或关闭此模式设置项只决定初始状态见 crates/settings_content/src/terminal.rs。路径超链接Path HyperlinksZed 会实时识别终端输出中的文件路径并让其可点击。CmdClickmacOS或CtrlClickLinux/Windows会在 Zed 中打开该文件若能识别到行号还会直接跳转。常见可识别格式包括src/main.rs:42—— 在第 42 行打开src/main.rs:42:10—— 在第 42 行第 10 列打开File script.py, line 10—— Python traceback。鼠标上报模式下的点击行为许多应用开启后会自己接管鼠标如vim设置mousea、htop。默认情况下即使应用启用了鼠标上报CmdClick/CtrlClick依然优先打开路径链接。如果你希望这类点击被转发给应用本身例如触发 vim 的光标定位可以关闭该行为{ terminal: { open_links_in_mouse_mode: false } }关闭后应用接管鼠标时打开链接的方式变为ShiftCmdClickmacOS或ShiftCtrlClickLinux/Windows。该默认值true同样记录在 assets/settings/default.json。自定义路径识别规则路径识别不是写死的正则而是可扩展的path_hyperlink_regexes配置见 assets/settings/default.json。规则支持命名捕获组path跳转目标路径、line、column、link指定终端里哪些文本被划为链接。默认内置两条规则Python 风格诊断File (?path[^]), line (?line[0-9])通用路径 可选行/列语法兼容引号包裹、行列为line:column与(line,column)两种写法。处理逻辑会停在第一个命中的正则因此注释建议把命中率高的规则排在前面以优化性能。同时还有path_hyperlink_timeout_ms默认1ms设为0会完全禁用路径超链接用于约束悬停/点击时做超链接探测的耗时预算。终端面板配置停靠位置Dock{ terminal: { dock: bottom } }可选值bottom默认见 assets/settings/default.json、left、right对应源码中的TerminalDockPosition枚举crates/settings_content/src/terminal.rs。默认尺寸{ terminal: { default_width: 640, default_height: 320 } }default_width停靠在左/右时的默认宽度默认640default_height停靠在底部时的默认高度默认320。与之相关的还有两个面板行为字段starts_open是否随启动自动展开终端面板默认false与flexible面板是否采用与编辑器成比例proportional的伸缩布局默认true。状态栏终端按钮终端面板图标默认显示在状态栏。隐藏方式{ terminal: { button: false } }若喜欢用快捷键或命令面板开关终端可以把它关掉以节省状态栏空间默认true。顺带一提还有一个show_count_badge选项可在终端面板图标上显示当前打开的终端数量角标默认false。工具栏与动态标题在终端窗格顶部的工具栏面包屑显示终端标题{ terminal: { toolbar: { breadcrumbs: true } } }标题可以由运行中的 Shell 通过 OSC 转义序列动态写入格式为\e]2;Title\007。例如在 bash 中执行echo -e \e]2;New Title\007即可把当前终端标签重命名为New Title参见 crates/settings_content/src/terminal.rs 中TerminalToolbarContent的说明。日常可让.bashrc/.zshrc在进入特定目录时发一条这样的序列标签页标题就会随上下文变化。滚动条与提示音补充项终端滚动条默认继承编辑器的滚动条设置terminal.scrollbar.show可显式指定auto/system/always/never见 crates/settings_content/src/terminal.rs。terminal.bell控制收到BEL字符\a时的行为system播放系统提示音、off静默。仓库默认配置 assets/settings/default.json 中为off。与任务系统Tasks的集成终端与 Zed 的任务系统天然打通当你运行一个任务Task时它会在终端中执行命令输出与手动输入的命令出现在同一视图里。更多任务定义见 Tasks 文档。在终端内可以快速重跑上一个任务macOSCmdAltRLinux/WindowsCtrlShiftR或AltT这些键位在默认配置中都绑定到terminal::RerunTask。例如 Linux 侧assets/keymaps/default-linux.json同时提供了ctrl-shift-r、ctrl-alt-r、alt-t三种等价触发方式。反复调试编辑 → 重跑 → 看输出的循环时非常顺手。AI 助手联动终端的报错信息可以一键交给内联助手解释macOSCtrlEnterLinux/WindowsCtrlEnter或CtrlI这会唤起 Inline Assistant用于解释报错原因、给出修复建议或直接建议可执行的命令键位对应动作assistant::InlineAssist见 assets/keymaps/default-macos.json。Zed 还为终端场景准备了专用的助手提示模板 assets/prompts/terminal_assistant_prompt.hbs让助手理解终端语义、给出贴合上下文的输出。详见 Inline Assistant 文档。更进一步Agent Panel 中的 AI Agent 可以在自己的工作流中直接执行终端命令——这意味着让 Agent 修完代码后顺手跑一遍测试并解读输出可以成为完整的闭环体验。向终端发送文本与按键对于高级键位定制Zed 提供了两个注入型动作可以把任意按键序列交给终端处理terminal::SendText—— 把一段原始文本写入终端支持\u001b这类转义适合发送 ESC 引导的序列terminal::SendKeystroke—— 模拟发送一次按键按键名采用 Zed 键位语法。自定义示例{ context: Terminal, bindings: { alt-left: [terminal::SendText, \u001bb], ctrl-c: [terminal::SendKeystroke, ctrl-c] } }这里的\u001bb即ESC b在 Readline 系 Shell 中表示光标向左跳一个词。事实上 Zed 的默认键位就是大量借助这两个动作实现的——例如 macOS 下alt-left→SendText \u001bb、cmd-left→SendKeystroke ctrl-a、cmd-backspace→SendKeystroke ctrl-u清空整行见 assets/keymaps/default-macos.json。以此为基础你可以为自己的工作流设计高度定制的一键宏。编辑键位文件的方式是通过命令面板执行zed::OpenKeymap或CmdK CmdS。完整设置参考上文只覆盖了最常用的终端配置。完整的terminal配置项清单含每个字段的默认值与取值范围可在 All Settings 文档的 Terminal 一节 查看也可以直接阅读仓库中的默认配置文件 assets/settings/default.json它本身就是一份带详细注释的最佳说明书。下一步Tasks —— 在 Zed 中定义并运行命令与脚本REPL —— 交互式代码执行CLI 参考 —— 用命令行在 Zed 中打开文件与目录。【免费下载链接】zedCode at the speed of thought – Zed is a high-performance, multiplayer code editor from the creators of Atom and Tree-sitter.项目地址: https://gitcode.com/GitHub_Trending/ze/zed创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
