Sublime Text安装与本地开发服务器联调方法

云伟君_1537

云伟君_1537

2026-07-24

712人浏览

原创

sublime text 自带的 sublimeserver 插件仅提供静态文件服务,不解析 php;因其基于 python http.server,无 php 解释器调用能力,故打开 .php 文件只会显示源码或下载。

sublime text安装与本地开发服务器联调方法

Sublime Text 本身不带本地开发服务器,但通过插件可快速启动一个轻量 HTTP 服务,仅支持静态文件(如 HTML/CSS/JS),不解析 PHP、Python 或 Node.js 后端逻辑。

为什么 Sublime 启动的本地服务器打不开 PHP 文件

因为 SublimeServer 插件本质是 Python 的 http.server 模块封装,只提供文件读取和 MIME 类型响应,不执行任何脚本。当你用它打开 index.php,浏览器只会下载或显示源码,不会运行 PHP 解释器。

  • 它不调用 php-cgi 或 php -S
  • 没有路由、中间件、session 支持
  • 所有请求都按静态资源处理,.php 后缀无特殊含义

如何正确配置并启动 SublimeServer

安装后必须满足两个前提才能在菜单中看到 SublimeServer 选项:当前窗口已打开一个文件夹项目(即侧边栏有根目录),且该文件夹内至少有一个 .html 文件。

Sublime Text Build Linux版
Sublime Text Build Linux版

Sublime Text Linux x86-64 deb 安装包。官方也提供 rpm、tar.xz 和软件源安装方式。

下载
  • 用 Ctrl+Shift+P 输入 Install Package → 安装 SublimeServer
  • 确保左侧侧边栏有项目根目录(不是单个文件)
  • 菜单栏 Tools → SublimeServer → Start SublimeServer 才会可用
  • 右键 HTML 文件 → View In SublimeServer,而非 Open In Browser
  • 默认端口是 8080,可在插件设置里改,但不要设为 80(需管理员权限)

想跑 PHP 或动态页面?换更合适的方案

如果需要真实执行 PHP,推荐直接用 PHP 自带的内置服务器,它比 SublimeServer 更可靠、更标准,且无需额外插件:

  • 终端进入项目目录,运行 php -S localhost:8000
  • 配合 -t 指定文档根目录,例如 php -S localhost:8000 -t public/
  • 支持路由文件(router.php),能处理伪静态和重写
  • Sublime 只负责编辑,保存后刷新浏览器即可,无需重启服务

调试时注意:PHP 内置服务器不支持 $_SERVER['HTTPS'] 或完整 CGI 环境变量,复杂框架需搭配 Nginx/Apache 或 Docker。

容易被忽略的路径和编码问题

SublimeServer 对中文路径、空格、特殊字符非常敏感——它底层依赖 Python 的 urllib.parse,但没做充分转义。常见表现是 404 或乱码 URL。

  • 避免在项目路径中使用中文、空格、括号(如 我的项目 (v2))
  • HTML 中引用的 CSS/JS 路径尽量用相对路径,不要用 file:// 协议
  • 如果页面加载后样式丢失,检查浏览器控制台的 Network 标签页,看是否因路径解析失败导致 404
  • Sublime 默认保存为 UTF-8 无 BOM,但若 HTML 声明了 charset=gbk,可能触发乱码,统一用 UTF-8

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
服务器是什么
服务器是什么

服务器是一种计算机硬件设备或软件程序,它具有强大的计算和存储能力,用请求、存储数据和提供服务。它在互联网中着关重要的作用,为用户提供各种服务和资源。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.15

437

5

连接apple id服务器时出错
连接apple id服务器时出错

连接apple id服务器时出错的原因包括网络连接问题、服务器问题、Apple ID账户问题、设备问题、防火墙或安全软件问题、时间和日期设置问题、Apple服务器维护等。本专题为大家提供apple id相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.08

880

5

搭建互联网服务器
搭建互联网服务器

搭建互联网服务器需要:1、选择合适的硬件和操作系统,第一步是选择合适的硬件和操作系统;2、安装和配置操作系统,是搭建互联网服务器的关键步骤;3、安装和配置服务器软件,是搭建互联网服务器的下一步,常见的服务器软件包括Apache、Nginx、Tomcat等;4、配置防火墙和安全性,是搭建互联网服务器的重要步骤;5、域名解析和配置,是搭建互联网服务器的最后一步。

2023.09.19

2672

5

如何查看服务器状态
如何查看服务器状态

查看服务器状态的方法有使用命令行工具、图形界面工具、监控工具、日志文件和远程管理工具等。本专题为大家提供服务器状态相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.09

896

5

服务器域名转接慢怎么解决
服务器域名转接慢怎么解决

服务器域名转接慢的解决办法有DNS优化、服务器优化、CDN加速、前端优化和网络优化等。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.17

809

5

服务器评测软件
服务器评测软件

服务器评测软件有PassMark Software、CPU-Z、GPU-Z、CrystalDiskMark、IOmeter、JMeter、LoadRunner、Apache Bench等等。详细介绍:1、PassMark Software是一款综合性的服务器性能测试软件,可以评估服务器在各种负载条件下的性能;2、CPU-Z是一款可以提供服务器CPU详细信息的软件等等。

2023.10.17

414

3

如何开启TFTP服务器
如何开启TFTP服务器

开启TFTP服务器的步骤包括选择TFTP服务器软件、下载和安装软件、配置TFTP服务器以及启动和测试服务器等。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.18

2416

4

服务器负载不兼容怎么解决
服务器负载不兼容怎么解决

解决方法:1、增加服务器资源;2、负载均衡;3、优化应用程序;4、增加缓存机制;5、分布式架构;6、限流和熔断;7、自动化扩容。想知道更详细服务器负载不兼容的解决方法,可以访问本专题下面的文章。

2023.10.20

4452

4

宽带如何接入服务器
宽带如何接入服务器

宽带接入服务器的方法有ADSL宽带接入服务器、光纤接入服务器、无线接入服务器和以太网接入服务器等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.20

727

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程