Atom本身没法直接“运行”HTML，它就是个编辑器。要实现浏览器同步刷新，得靠一套组合拳：写好文件 → 保存 → 启动本地HTTP服务 → 浏览器用`http://`协议访问 → 文件一变就自动触发重刷。别指望双击文件或右键“Open in Browser”就能搞定，那只会撞上`file://`协议的跨域限制、路径解析失败、ES模块加载报错这些坑，来回折腾还找不到原因。
把话说透：Atom本职就是写代码，不负责“运行”。所谓运行，其实是搭一条外部协作链——写、保存、起HTTP服务、浏览器用`http://`访问、文件变动触发刷新。很多人卡在第一步，以为双击就能预览，结果被困在`file://`的跨域和路径死结里。
atom-live-server 插件怎么起服务才真正生效
这个插件不是装完就自动监听全项目的。它的逻辑很直白：以当前打开的HTML文件所在目录为根路径，只监控该目录及其子目录下的文件变更。操作上有几个关键点：
- 安装后必须重启Atom。终端执行
apm install atom-live-server，然后重启——不重启插件不加载。 - 打开目标HTML文件，按
Ctrl+Alt+L（Windows/Linux）或Cmd+Alt+L（macOS），浏览器会自动弹出http://localhost:3000/index.html。 - 如果改了
assets/css/style.css但没刷新，八成是index.html和assets/不在同级目录。把HTML文件移到项目根，或者把CSS移到它同级的css/目录下就能解决。 - 端口被占用时，插件会自动顺延到3001、3002……但它不会弹出提示。手动检查终端输出，或者用
lsof -i :3000（macOS/Linux）／netstat -ano | findstr :3000（Windows）确认一下实际端口。
为什么 open-in-browser + http-server 组合总刷不出新内容
这个问题最常见，但原因并非插件没装好，而是协议和缓存没对上——它们根本不在一条链路上。
open-in-browser默认打开的是file://地址，跟你终端起的http-server完全无关。得手动把地址栏改成http://localhost:8000/，端口必须和你起的服务一致。- 没加缓存禁用参数，浏览器会读旧资源。运行
npx http-server -c-1 -p 8000，其中-c-1表示禁用缓存。 - Atom没添加项目根目录（
File → Add Project Folder），导致http-server解析相对路径出错。比如./js/main.js实际在src/js/main.js，就会返回404。 - 别同时开
atom-html-preview，它默认也占3000端口，和atom-live-server冲突，浏览器会一直卡在“Connecting…”状态。
路径补全为什么总找不到 assets/images/logo.png
autocomplete-html的src补全是静态扫描，不递归、不解析HTML结构、也不看当前文件位置。它只扫描core.projectHome所设路径下一级的.jpg／.png文件。比如你设了/my-site，那只有/my-site/logo.png能被补全，/my-site/assets/images/logo.png就不行。
解决方法有两招：
- 在
config.cson里显式设置core: { projectHome: "/path/to/my-site" }，确保指向包含assets/的父目录。 - 放弃自动补全，改用
html-snippets插件，输img加Tab快速生成标签，然后手敲路径——更快、更可控。
顺便提醒一下：fuzzy-finder是用来跳文件的，不是补src值的，别把它和路径补全搞混。
实时刷新失效时最先查哪三件事
不用翻日志、不用重装插件，90%的问题就藏在这三个地方：
- 浏览器地址栏是不是
http://开头？如果是file://，那任何Live Server都无效。 - 控制台有没有404？比如
GET http://localhost:3000/css/style.css 404，说明HTML里写的路径和实际文件位置不匹配。 - Atom底部状态栏有没有显示“Live Server: Running on http://localhost:3000”？没显示说明服务根本没起来，检查快捷键是否被系统或其他软件拦截——某些输入法会吃掉
Ctrl+Alt+L。
真正卡住人的从来不是“怎么让页面动起来”，而是路径、协议、插件三者之间互相咬死。调通一次后，删掉所有非必要插件，config.cson里只留四五行配置，比堆一堆全家桶还稳。
