应卸载 terminal-plus,改用 platformio-ide-terminal(仅兼容 atom ≤1.60),安装后需设 default working directory 为 project folder、启用 pty(macos/linux)、配置 shell override(windows),并确保已添加项目根目录才能触发快捷键。

别装 Terminal-Plus,它已归档且与 Atom 1.60+ 完全不兼容
现在(2026 年)装 terminal-plus 是踩坑起点。它的 GitHub 仓库已 archived,APM 安装后大概率触发 PTY signal lost、node not found 或 Atom 崩溃。这不是配置问题,是底层架构失效——它依赖的 pty.js 早已被现代 Node.js 和 Electron 版本弃用。
你看到的“安装成功”只是假象;后续所有快捷键失效、右键菜单空白、终端启动卡死,都是必然结果。直接卸载:apm uninstall terminal-plus 或 atom-terminal-tab,再继续下一步。
只装 platformio-ide-terminal,且必须确认 Atom 版本 ≤1.60
platformio-ide-terminal 是目前 Atom 中唯一还能跑的终端插件,但它仅稳定支持 Atom v1.58–v1.60。运行 atom --version,若输出为 1.61.0 或更高,必须降级——去 Atom releases 下载 v1.60.0 安装包手动覆盖。
安装命令仅一条:apm install platformio-ide-terminal。不要加 @latest,也不要搜“terminal”其他变体。安装后重启 Atom,否则设置页不会出现。
- Windows 用户:务必在 Settings → Packages →
platformio-ide-terminal→ Settings 中填对Shell Override,例如C:\Program Files\Git\bin\bash.exe - macOS/Linux 用户:必须勾选
Enable PTY,否则Ctrl+C无法中断进程 - 所有平台:勾选
Run command in login shell,否则npm、pio等命令会报command not found
Ctrl+` 没反应?检查项目根目录和系统热键冲突
platformio-ide-terminal 的快捷键 Ctrl+`(Windows/Linux)或 Cmd+`(macOS)只在有项目根目录时激活。刚启动 Atom 空界面按它,完全静默——这是设计行为,不是 bug。
正确流程是:File → Add Project Folder,选一个含 platformio.ini、package.json 或甚至只是 README.md 的文件夹。添加后,快捷键才生效。
Mac 用户额外注意:Cmd+` 被系统用于切换同一 App 内窗口,会劫持插件热键。临时关闭系统快捷键(System Preferences → Keyboard → Shortcuts → Keyboard → Move focus to next window),或改插件的 Keymap for Toggle 为其他组合键。
终端打开但 pwd 错了?Default Working Directory 必须设为 Project folder
新建终端后执行 pwd 返回 /home/xxx 或 /Applications/Atom.app/...?说明工作目录没自动跳转到项目根。这不是插件故障,是设置未生效。
进 Settings → Packages → platformio-ide-terminal → Settings → Core,把 Default Working Directory 明确选为 Project folder(不是 Active file directory,后者在多根项目中极易错乱)。
若仍无效,终端里手动 cd 到含 platformio.ini 的目录再操作;别依赖“自动定位”。Windows 用户若用 PowerShell 作为 shell,常卡在 PS C:\> 不响应,此时换 cmd.exe 或 bash.exe 更稳。
复杂点在于:这个插件没有“终端会话继承当前编辑器路径”的逻辑,也没有右键菜单管理标签页的功能。所有切换都靠键盘——Ctrl+1~Ctrl+9 跳指定标签,Ctrl+Shift+[/] 顺序切,鼠标点击标签页本身是无效操作。











