必须重启Atom才能使atom-live-server插件生效，否则快捷键Ctrl+Alt+L无反应、菜单项灰显、右键无选项；插件以当前打开的HTML文件所在目录为根路径监听变更，且浏览器必须通过http://协议访问（如http://localhost:3000/index.html），file://协议会导致fetch、@import、ES模块等全部失效。
atom-live-server 插件必须重启 Atom 才生效
装完 atom-live-server 后按 Ctrl+Alt+L 没反应？不是快捷键冲突，是插件根本没加载。Atom 不会热加载新插件，apm install atom-live-server 之后必须完全关闭 Atom（包括后台进程），再重新打开。重启后右下角状态栏出现 Live Server: idle 才算就绪。
常见失效现象：
- 菜单 Packages > Atom Live Server > Start Server 灰掉
- 快捷键无输出、控制台也无报错
- 右键 HTML 文件没有 Start Live Server 选项
服务根路径由当前打开的 HTML 文件决定
atom-live-server 不以项目根目录为监听起点，而是以「当前在编辑器中打开的那个 index.html 文件所在目录」为根路径。改 assets/css/style.css 却不刷新？大概率是因为该 CSS 不在 index.html 的同级或子目录下。
- 先在 Atom 中单独打开你要预览的
index.html（不是只打开文件夹） - 确保右下角显示语法为
HTML，否则插件可能识别失败 - 启动后浏览器自动跳转到
http://localhost:3000/index.html—— 这个地址必须是http://，绝不能是file://
file:// 协议会导致几乎所有现代 Web 功能失效
双击 HTML、右键“Open in Browser”、拖进浏览器窗口……这些操作都走 file:// 协议，结果就是：
- @import 的 CSS 文件不加载
- fetch() 报 TypeError: Failed to fetch（CORS 阻止）
- ES 模块（type="module"）加载失败，提示 Access to script at 'file://' from origin 'null' is denied
- 本地图片、字体、API 请求全部挂掉
正确做法只有一条：等 atom-live-server 启动后，让它自己打开浏览器，或手动访问 http://localhost:3000/xxx.html。端口被占时它会顺延到 3001、3002……但不会主动提示，得看 Atom 底部状态栏的实际端口号。
热更新不触发的三个隐藏原因
即使服务起来了、地址也对了，仍可能不刷新。最容易被忽略的是：
- 改的是
@import引入的 CSS 文件 →atom-live-server只监听<link rel="stylesheet">和<script></script>标签引入的资源，不响应@import - HTML 文件和被修改文件不在同一目录层级（比如
index.html在/src/，而style.css在/assets/） - 同时启用了
atom-html-preview插件 → 它默认也占3000端口，和atom-live-server冲突，浏览器卡在 “Connecting…”
真要稳定，不如直接在终端进项目根目录执行 npx live-server --port=8080，错误直接打在终端里，端口冲突、缓存问题一目了然。
