atom-live-server 启动后浏览器打不开或卡在 Connecting…90% 是协议或端口问题，必须用 http://localhost:3000/index.html 访问，file:/// 无效；端口被占会静默顺延，需查终端输出或用 lsof/netstat 确认；资源须与 HTML 同级或子目录，@import 不触发刷新；404 或 fetch 失败多因路径错误或误用 atom-html-preview；快捷键失效常因系统冲突或未重启 Atom；自动刷新需 http 协议+本地服务，编辑器内预览则不执行 JS、不响应变更。
atom-live-server 启动后浏览器打不开或卡在 Connecting…
90% 是协议或端口问题，不是插件坏了。
- 必须用
http://localhost:3000/index.html这类地址访问，file:///协议完全无效 - 插件默认占
3000端口，被占用时会静默顺延到3001、3002……但不提示；可查 Atom 底部终端输出，或运行lsof -i :3000（macOS/Linux）或netstat -ano | findstr :3000（Windows）确认端口状态 - 别同时启用
atom-html-preview或open-in-browser，它们也默认监听3000，会冲突
改了 CSS/JS 但页面不自动刷新
不是插件失灵，而是监听路径没覆盖到文件。
-
atom-live-server只监听「当前打开的 HTML 文件所在目录及其子目录」：比如你在/project/src/index.html启动服务，但style.css在/project/assets/，改它不会触发刷新 - 解决办法：把资源（
.css、.js、images）移到和 HTML 同级或子目录下，确保能用相对路径引用，例如./css/style.css -
@import的 CSS 文件变更不会被检测，只响应<link>和<script>标签引入的资源
浏览器控制台报 404 或 fetch 失败
说明路径写错，或用了不支持的协议上下文。
-
GET http://localhost:3000/assets/style.css 404→ 检查 HTML 中href或src路径是否对得上服务根路径（即 HTML 所在目录） -
fetch()报错、XMLHttpRequest失败、Service Worker注册失败 → 你可能误用了atom-html-preview，它不走 HTTP 协议，所有依赖网络栈的 API 都不可用 -
../assets/style.css可加载，但/assets/style.css或https://cdn.example.com/style.css会失败 ——atom-html-preview基于文件系统解析，不模拟服务器路由
快捷键 Ctrl+Alt+L 或 Ctrl+Shift+H 不生效
常见原因不是插件没装好，而是环境或配置卡点。
立即学习“前端免费学习笔记（深入）”；
-
Ctrl+Alt+L（atom-live-server）失效：常因系统级快捷键冲突（如输入法、录屏工具），可在 Atom 的Keymap中重绑定为Ctrl+F12等 -
Ctrl+Shift+H（atom-html-preview）无效：先看右下角状态栏是否显示HTML—— 若是Plain Text，说明 Atom 没识别文件类型；确保已保存且扩展名为.html - 插件安装后必须重启 Atom，否则快捷键不注册；
apm install命令装完也一样要重启
http:// 协议 + 本地服务；想嵌入编辑器看结构，就得接受它不执行 JS、不处理 @import、不响应文件变更。这两个目标没法同时满足，选哪个取决于你此刻在调试什么。 
