Ctrl+` 按了没反应，先确认项目是否已加载
platformio-ide-terminal 不是装完就全局生效的插件——它只在 Atom 已加载项目根目录时才响应快捷键。刚启动 Atom、只打开单个文件或空白窗口，Ctrl+`（Windows/Linux）或 Cmd+`（macOS）会完全静默，不报错也不弹窗。
必须执行：File → Add Project Folder，选一个含 platformio.ini、package.json 或至少一个 README.md 的目录；再试快捷键。Mac 用户注意：Cmd+` 常被系统 Spotlight 占用，临时关闭系统热键再试。
若仍无效，可手动绑定快捷键：编辑 keymaps/base.cson，加一行：'atom-workspace': 'ctrl-`': 'platformio-ide-terminal:toggle'
终端面板空白或报 pty.start is not a function
这是 Atom 版本与插件底层不兼容的明确信号。platformio-ide-terminal 仅支持 Atom ≤ v1.60；当前 Atom（2026 年最新版）已升级 Electron 和 Node.js 运行时，该插件依赖的 node-pty 旧版 API 已被移除。
验证方法：打开开发者工具（View → Developer → Toggle Developer Tools），切到 Console 标签页，刷新 Atom，看是否有类似错误：Uncaught TypeError: pty.start is not a function
此时没有修复路径，只有两个现实选择：
• 降级 Atom 到 v1.60（不推荐，安全与功能受限）
• 放弃插件，改用系统终端联动（如 macOS 的 open -a "Terminal" "$PWD"，Windows 的 wt -d "%CD%"）
终端能打开但命令找不到，比如 bash: node: command not found
这不是插件故障，是 Atom 启动时未继承 shell 配置（如 ~/.zshrc），导致 $PATH 缺失关键路径。系统终端里能跑的命令，在插件终端里照样失效。
必须勾选插件设置里的 Run command in login shell（关键！其他设置不勾这个全白搭）
Windows 用户若用 Git Bash，还需在 Shell Override 填完整路径，例如：C:/Program Files/Git/bin/bash.exe
验证是否生效：终端里执行 echo $PATH，对比系统终端输出是否一致。若不一致，说明 shell 配置未加载成功。
终端里 Ctrl+C 失效，服务卡在 “Starting development server…”
现代前端工具（Vite、Vue CLI 等）依赖伪终端（PTY）接收 SIGINT 信号。platformio-ide-terminal 默认禁用 PTY，导致 Ctrl+C 被忽略，进程持续占用端口。
解决方法：进插件设置，开启 Enable PTY (Pseudo-Terminal)（Linux/macOS 强制开；Windows 需搭配 Git Bash 才有效）
注意：
• 关掉终端面板右上角 × 不等于终止进程——它只是隐藏，后台仍在跑
• 真要停服务，必须切回终端窗口，手动按 Ctrl+C
• 若仍无响应，检查 Atom 是否以管理员/Root 权限启动（权限过高反而阻断 PTY 初始化）
