终端故障排除

终端打开了，但输入没有任何反应

症状： 按键没有在终端里显示，或者终端打开后一直是空白屏幕。

可能的原因和解决方法：

Shell 初始化文件报错。 你的 shell 启动文件（.zshrc、.bashrc 或 .bash_profile）可能有语法错误，或者有某条命令卡住了。在 1DevTool 里打开一个普通的 Bash 终端，运行：

cat ~/.zshrc

找找明显的错误——缺少结束引号、引用了不存在的变量、或者 source 了一个不存在的文件。在文本编辑器里修正错误后，重新打开终端。

终端类型选错了。 如果你选了"Claude Code"类型的终端，但系统里还没装 claude CLI，终端虽然会打开，但 shell 无法启动 AI 助手。先安装 Claude Code（npm install -g @anthropic-ai/claude-code），或者把终端类型改成普通的 Bash 或 Zsh 会话。

快速重置。 右键点击终端标签，选择 Restart Terminal。这会终止当前的 shell 进程并启动一个新的，不需要关闭面板。

AI 助手对输入没有反应

症状： 在 AI 终端里输入指令后什么都没有发生——没有加载动画，没有回复，没有任何反馈。

最常见的原因是 AI 的界面进入了某个子模式，此时它不会读取你的输入。比如，如果 AI 在终端里打开了 vim 或 nano 这类文本编辑器，你的按键会被发送给编辑器，而不是 AI。

解决方法：

• 按一两次 Ctrl+C，取消 AI 当前正在做的事情，让它回到主提示符。然后重新输入你的指令。
• 改用 AI 指令输入框代替直接在终端里输入。按 Cmd+I（Windows/Linux 上是 Ctrl+I）打开专用输入框，它会把你的指令干净地发送给 AI，绕过终端的状态问题。
• 如果 AI 完全卡死，右键点击终端标签选择 Restart Terminal，启动一个新的 AI 会话。

AI 回复后历史记录被截断

症状： AI 产生了很长的输出后，向上滚动时只能看到一部分，更早的内容消失了。

解决方法：

• 点击终端顶部工具栏里的 展开历史 按钮（终端面板右上角的箭头图标），这会临时加载更多历史记录。
• 要永久解决这个问题，增大历史行数上限：进入 Settings → Terminal → Scrollback Lines。默认是 10,000 行，最高可以设置到 100,000 行。注意历史缓冲区越大，占用内存越多。

终端里出现了 "[detached]" 消息

你可能会在终端顶部看到类似 [detached (from session main)] 这样的一行文字。这是 tmux 发出的消息，tmux 是 1DevTool 用来在后台保持会话存活的终端复用工具。

这条消息表示显示层暂时与正在运行的会话断开了连接，然后又重新连上了。这完全正常——通常发生在你切换项目、隐藏后重新打开终端，或者应用从最小化状态恢复时。你的会话和所有正在运行的进程都不受影响。

隐藏的终端重新打开后从头开始而不是继续

症状： 你隐藏了一个终端（比如点击到别的地方或关闭了面板），重新打开后终端从头开始了——之前的命令历史和正在运行的进程全没了。

原因： 1DevTool 依赖 tmux 在后台保持终端会话存活。如果 tmux 没有安装或者不在 shell 的 PATH 里，会话就无法持久化，每次都会重新启动。

解决方法： 安装 tmux，然后重启 1DevTool。

• macOS： brew install tmux
• Linux（Debian/Ubuntu）： sudo apt install tmux
• Linux（Fedora/RHEL）： sudo dnf install tmux

安装完成后，完全退出 1DevTool 再重新启动。之后新建的终端会话在隐藏后都能正常持久化。

终端进程导致 CPU 占用率过高

如果你的电脑风扇狂转或发热明显，可能是某个终端进程在大量消耗 CPU。

定位来源： 将鼠标悬停在各个终端标签上，活跃状态的标签会显示旋转动画。你也可以在终端里运行 top 或 htop，直接看哪个进程占用了资源。

停止它：

• 在终端里按 Ctrl+C 中断正在运行的进程。
• 或者右键点击终端标签，选择 Kill Process，强制终止其中运行的所有内容。

如果是失控的开发服务器或构建工具，直接终止是安全的，之后用正常的启动命令重新跑一次即可。