简介
在使用 Qoder IDE 智能体模式时，终端执行高度依赖于你的本地环境和 shell 配置。你可能会遇到以下问题：
- 无法启动终端
- 命令无法执行
- 没有任何输出
常见故障排查方法
方法 1：配置受支持的 shell
Qoder IDE 支持多种 shell。请确保你使用的是兼容的 shell。
- 打开 Qoder IDE。
- 按下
Cmd + Shift + P（macOS）或Ctrl + Shift + P（Windows/Linux）打开命令面板（Command Palette）。 - 输入
Terminal: Select Default Profile并选择该项。 - 选择一个受支持的 shell：
- Linux/macOS：
bash、fish、pwsh、zsh - Windows：
Git Bash、pwsh
- Linux/macOS：
- 完全关闭并重新打开 Qoder IDE 以使更改生效。
方法 2：手动安装 shell 集成
如果终端集成仍然失败，请在 shell 的配置文件中添加相应语句来手动安装 shell 集成。
zsh（~/.zshrc）：
~/.bashrc）：
$Profile）：
~/.config/fish/config.fish）：
- 保存更改。
- 完全重启 Qoder IDE。
如需其他 shell 的配置方法，请参阅 VS Code 官方文档。
如果问题仍然存在
如果你仍然看不到终端输出：
- 点击 Terminate Terminal 按钮以关闭当前终端会话。
- 重新运行该命令。这会刷新终端连接，通常能解决临时性问题。
Windows 专属故障排除
Git Bash
- 从 https://git-scm.com/downloads/win 下载并安装 Windows 版 Git。
- 退出并重新打开 Qoder IDE。
- 将 Git Bash 设为默认终端：
a. 打开命令面板（Command Palette）。
b. 运行：
Terminal: Select Default Profile。 c. 选择 Git Bash。
PowerShell
1. 确保使用 PowerShell 7 或更高版本
查看当前版本：
- 按下
Win + X - 选择 Windows PowerShell（管理员） 或 Windows Terminal（管理员）
Y 确认，然后验证：
WSL
如果使用 Windows Subsystem for Linux（WSL）：
- 在你的
~/.bashrc中添加以下一行：
- 重新加载你的 shell，或运行
source ~/.bashrc。 - 在 Qoder IDE 中再次尝试该终端命令。
异常终端输出
症状：
- 乱码、方块符号
- 转义序列（例如：
^[[1m、^[[32m） - 命令输出被截断或格式混乱
方案一：为 Agent 执行终端禁用复杂提示或主题（长期使用）
通过检查 QODER_AGENT 这个环境变量来判断 Agent 是否正在运行。如果是，在启动 Shell 时不加载复杂的主题或提示符配置，从而避免问题。
方案二：暂时禁用
在 shell 配置文件中注释掉主题相关配置，重启 Qoder IDE 测试。如果问题解决，逐项重新启用以定位冲突组件。
例如，在 ~/.zshrc 中注释 Powerlevel10k：