Atom 本身不运行代码，所有执行依赖插件调用系统命令；需确保解释器已安装、PATH 正确、文件语法类型（grammar）匹配、扩展名已绑定，且 Python/Node 脚本注意缓冲区与 stdin 限制，前端需 HTTP 服务而非 file:// 协议。
Atom 本身不编辑也不运行代码——它只负责高亮、缩进、自动补全等文本操作；所有“运行”动作都靠插件调用系统命令，而能否成功，取决于你本地有没有装对解释器、PATH 是否生效、文件后缀和语言识别是否匹配。
script 插件按 Ctrl+I 没反应？先看右下角语言状态
Atom 不靠文件名后缀自动绑定运行逻辑，而是依赖右下角显示的 grammar（语法类型）。如果显示的是 Plain Text，哪怕文件叫 hello.py，script 插件也压根不会尝试调用 python。
- 点右下角语言名 → 手动选
Python或JavaScript - 快捷键更省事：
Ctrl+Shift+L（Win/Linux）或Cmd+Shift+L（macOS），输入语言名回车 - 永久绑定扩展名：在
Settings → Packages → script → Settings里填File Extensions，如py,js,sh,ts（注意全小写） - 如果用了
.mjs或.jsx，默认不识别，得手动切 grammar 或配自定义命令
运行报 command not found: python 或 node？不是插件问题
script 插件只是个“传话筒”，它默认执行 python 或 node 命令，但这些命令是否存在、是否在 PATH 里，完全由你的终端环境决定。在 Atom 里点运行失败，90% 是因为 GUI 启动的 Atom 没继承 shell 的 PATH。
- 先在终端里跑
python --version和which python3，有输出才说明环境就绪 - macOS 用户：别从 Dock 点开 Atom，改用终端执行
open -a "Atom"，否则~/.zshrc里的 PATH 不生效 - Windows 用户：确认安装 Python 时勾了
Add Python to PATH；没勾就手动填绝对路径，比如C:/Users/me/AppData/Local/Programs/Python/Python311/python.exe - Linux/macOS 推荐直接在
script设置里把Command改成python3或node，别用模糊的python
Python 脚本卡住不输出？缓冲区没刷出来
Python 默认行缓冲（line-buffered）只在连接 TTY 时生效；script 插件默认非交互式执行，print() 输出会卡在缓冲区，直到脚本退出才一次性刷出，看起来像“假死”。
- 临时解决：在
print()后加flush=True，例如print("done", flush=True) - 一劳永逸：在
script设置里把Command改成python3 -u（-u强制未缓冲模式） - 带
input()的脚本？script默认不支持 stdin 输入——必须启用终端模式：运行前按Ctrl+I，或设置里勾选Use Terminal（不是Use Script Panel） - 启用终端后，工作目录不会自动切换到文件所在路径，
Cannot find module 'xxx'很可能只是路径不对，得手动cd
HTML / JS 项目打开空白页？file:// 协议根本跑不了现代前端
右键 → Open in Browser 类插件只是用 file:// 协议打开本地 HTML，没有 HTTP 服务，所有 fetch()、import、相对路径引用都会因跨域或协议限制失败。
- 静态服务起步最快：
python3 -m http.server 8000（Python 自带）或npx http-server -p 8000 - 要热重载：
npx live-server --port=8000，保存即刷新，错误打在终端里，比弹窗好排查 - C / C++ 编译报
gcc not found？c++-build插件不自动找编译器，得去设置里填绝对路径，比如/opt/homebrew/bin/gcc-14（Apple Silicon）或/usr/bin/gcc（WSL） - SQL 文件不能直接 run，
script默认调sql命令（系统一般没有），要么手动配mysql -u root -p db，要么换atom-sql-runner
真正卡住的时候，往往不是 Atom 不行，而是你在用编辑器当 IDE 使——它不管理依赖、不启动服务、不处理环境变量继承、也不提供调试器。每一步“运行”背后，都是你本机命令行能力的真实映射。
