Sublime Text 4 默认不带 SublimeServer，需手动安装插件；必须将文件夹添加为项目才能启动服务，否则报“File not in Sublime Project Folder”；原版 SublimeServer 已停更，推荐使用兼容 ST4 的 SimpleHTTPServer 插件，或改用系统自带的 python -m http.server。
Sublime Text 4 能跑 SublimeServer，但默认不带，必须手动装插件；而且它对项目结构有硬性要求——文件不在 Sublime 的「项目」里，View in SublimeServer 会直接报错，不是端口或路径问题，是根本没被识别。
SublimeServer 插件安装失败的常见原因
多数人卡在第一步：命令面板输 Install Package 后搜不到 SublimeServer。这不是网络问题，而是插件名已失效——原作者早已停止维护，GitHub 上的仓库（sublime-server）已归档，Package Control 默认源里不再收录它。
- 别搜
SublimeServer或sublime serve，这两个都找不到 - 实际可用的替代插件是
SimpleHTTPServer（支持 ST4，纯 Python 实现，无依赖） - 如果坚持用原版，只能手动下载 ZIP 包，解压后放入
Packages目录（路径：Preferences → Browse Packages…），但需注意 Python 版本兼容性——ST4 默认用 Python 3.8+，而老版SublimeServer基于 Python 2.6 写的，运行会抛ImportError: No module named urllib2
启动服务前必须添加项目文件夹
SublimeServer 不是从当前打开的单个文件启动服务，而是以整个项目根目录为 Web 根路径（DocumentRoot）。如果你只是双击打开一个 index.html，右键点 View in SublimeServer 一定会提示：File index.html not in Sublime Project Folder!
- 必须先执行
Project → Add Folder to Project…，选中含 HTML/CSS/JS 的完整文件夹 - 左侧边栏出现文件树，且顶部显示项目名，才算成功加入项目
- 服务启动后，访问地址是
http://localhost:8080/your-file.html，不是file://协议，跨域、AJAX、相对路径才正常
端口被占用或手机无法访问的排查点
默认端口 8080 经常被其他程序（如 Docker、Java 进程、甚至 Chrome 扩展）占着；另外公司 Wi-Fi 通常禁用了局域网设备互访，换网线直连或开热点才通。
- 改端口：进
Tools → SublimeServer → Settings，改"port": 8090（保存后需重启服务） - 查端口占用：Windows 运行
netstat -ano | findstr :8080，macOS/Linux 用lsof -i :8080 - 手机访问时，浏览器地址栏填的是你电脑的局域网 IP（如
192.168.1.105:8080），不是localhost，也不是127.0.0.1 - 防火墙要放行对应端口，Windows Defender 防火墙里需勾选「专用网络」允许入站
真正容易被忽略的是：这个插件不处理 MIME 类型自动推断，比如打开 data.json 会返回 text/plain 而非 application/json，导致前端 fetch() 解析失败；如果需要正确响应头，得自己改插件里的 mimetypes 字典，或者直接换用 python -m http.server 8080 更省事。
