ctrl + ` 无反应需先加载含 platformio.ini 等文件的项目目录；终端命令失效须启用“run command in login shell”；pio run 找不到配置文件应设默认工作目录为 project folder；上传失败先运行 pio device list 排查设备。
Ctrl + ` 按了没反应？先确认项目是否已加载
platformio-ide-terminal 不是装完就自动可用的插件——它只在 Atom 已加载项目根目录时才响应快捷键。刚启动 Atom、没打开任何文件夹，按 Ctrl + `（Windows/Linux）或 Cmd + `（macOS）会完全静默，不报错也不弹窗。
必须先执行：File > Add Project Folder，选一个含 platformio.ini、package.json 或至少一个 README.md 的目录；再试快捷键。
- Mac 用户注意：系统级
Cmd + `（应用切换）可能劫持该组合键，临时关闭系统热键再试 - 去
Atom > Settings > Packages > platformio-ide-terminal > Settings检查Keymap for Toggle是否被意外改写 - 若仍无效，重启 Atom 后手动在命令面板中运行
platformio-ide-terminal:toggle
终端里 pio、npm 命令报 “command not found”？关键在登录 Shell
Atom 启动时不加载你的 ~/.zshrc 或 ~/.bashrc，所以即使终端里能跑的命令，在 Atom 终端里也会消失。这不是 PATH 配置错误，而是 shell 初始化缺失。
唯一有效解法：勾选插件设置中的 Run command in login shell。不勾这个，其他设置都白搭。
- Windows 用户若用 Git Bash，还需在
Shell Override中填入真实路径，例如：C:\Program Files\Git\bin\bash.exe - PowerShell 在 Windows 上常卡在
PS C:\>无响应，建议改用cmd.exe或 WSL 的bash.exe - 别信 “Use PlatformIO IDE Terminal as default terminal” 这类开关——它只改面板归属，不修复环境变量
npm run dev 卡在 “Starting development server…”？其实是 Ctrl + C 失效
这不是卡死，是伪终端（PTY）信号转发被禁用。create-react-app、vue-cli-service 等服务依赖 SIGINT 信号中断进程，而默认配置下收不到。
必须启用：Enable PTY (Pseudo-Terminal)。Linux/macOS 用户必开；Windows 用户启用后需搭配 Git Bash 才生效。
- 已运行的服务不能靠点击面板右上角 × 关闭——那只是隐藏面板，进程仍在后台占端口
- 务必用
Ctrl + C手动终止，否则下次启动会提示端口被占 - 如果
Ctrl + C仍无效，检查 Atom 是否以管理员/Root 权限启动：高权限反而干扰 PTY 初始化，尤其 Windows 上常见
为什么 pio run 找不到 platformio.ini？工作目录没设对
新建终端后 pwd 常是 ~ 或 Atom 安装目录，而非项目根目录。插件默认行为不稳定，尤其在多根项目中。
进 Settings > Packages > platformio-ide-terminal > Core，把 Default Working Directory 明确设为 Project folder（不是 Active file directory）。
- Windows 用户若用 PowerShell，该设置常失效，直接改用
cmd.exe或bash.exe更稳 - 实在不行，就手动
cd到含platformio.ini的目录再操作——别信 UI 自动定位 - 上传失败时弹出 “No serial ports found”，90% 是驱动或权限问题，先在终端里跑
pio device list看真实设备是否列出
PlatformIO IDE 插件本身已在 2025 年起停止维护，Atom v1.60 + platformio-ide v2.7.2 是最后稳定组合；新项目强烈建议迁移到 VS Code + PlatformIO IDE。当前所有兼容性问题，根源都在 Atom 插件 ABI 断层和 Electron 升级冲突，不是配置能彻底绕过的。
