atom-live-server 插件实现「保存即刷新」需重启 Atom 才生效，必须通过 http:// 协议访问（非 file://），监听范围限于当前 HTML 文件所在目录及子目录，仅响应 <link> 和 <script> 引入的资源变更。
Atom 本身不运行 HTML，atom-live-server 插件才是让「保存即刷新」真正落地的关键——但它不是开箱即用，配置错一步，浏览器就卡在 file:// 协议里不动，连 CSS 都不加载。
安装后必须重启 Atom，否则快捷键不生效
插件安装命令是 apm install atom-live-server，但装完直接试快捷键大概率失败。原因很实在：Atom 的命令注册发生在启动阶段，插件包是在内存里动态加载的，不重启就不会执行 main.js 里的 atom.commands.add 注册逻辑。
- 关掉所有 Atom 窗口（包括后台进程），再重新打开
- 确认右下角状态栏显示语言模式为
HTML，不是Plain Text；否则右键菜单里压根没Start Live Server选项 - 快捷键默认是
Ctrl+Alt+L（Windows/Linux）或Cmd+Alt+L（macOS），若无效，进Atom → Settings → Keymap检查是否被系统或其他插件占用
必须用 http:// 打开页面，file:// 协议下一切都会失效
atom-live-server 起的是本地 HTTP 服务（默认端口 3000），它靠 location.reload() 刷新，而这个 API 在 file:// 下受限严重：跨域报错、@import 的 CSS 不解析、fetch() 直接拒绝、相对路径引用也容易 404。
- 启动服务后，浏览器地址栏一定是类似
http://localhost:3000/index.html的格式，绝不能是file:///C:/project/index.html - 如果误点了双击打开，关掉那个标签页，回到 Atom 按快捷键重启服务——它会自动新开正确协议的页面
- 端口被占时，插件会顺延到
3001、3002……但不会提示，若页面打不开，先打开浏览器开发者工具，看 Console 是否报ERR_CONNECTION_REFUSED，再手动试http://localhost:3001
文件监听范围只限当前 HTML 所在目录及子目录
它不是监听整个项目根目录，而是以你「当前打开的 HTML 文件」为锚点，只监视该文件路径及其子级。比如你在 /project/src/index.html 启动服务，但 style.css 放在 /project/assets/，改完保存，页面根本不会刷新。
- 检查浏览器 Network 标签页，看是否有
404请求，比如GET http://localhost:3000/assets/style.css 404—— 这说明路径没对上 - 要么把资源文件移到
src/或其子目录下（如src/css/style.css），要么调整 HTML 中的引用路径，确保能被服务器路由到 -
@import的 CSS 文件变更不会触发刷新，只响应<link rel="stylesheet">和<script>标签引入的资源
别依赖右键菜单，优先用快捷键或命令面板
右键菜单里的 Start Live Server 有时会消失，尤其在多标签页切换、项目未聚焦或 Atom 状态异常时。它本质是调用同一个命令，但触发路径更脆弱。
- 推荐始终用快捷键
Ctrl+Alt+L（或对应平台组合键）启动 - 或者按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）呼出命令面板，输入atom-live-server:start-server手动执行 - 需要指定端口？直接用预置命令：
atom-live-server:start-4000、atom-live-server:start-8000，比改配置文件更直接
最常被忽略的一点：插件不处理任何构建流程，也不转发请求。它就是一个最小 HTTP 服务 + 文件监听器。想代理 API、热替换 CSS、多设备同步？得换 BrowserSync 或现代构建工具。别指望它做超出设计范围的事。
