一套面向 PHP 开发的 Sublime Text 配置整理

小鹿同学
小鹿同学
发布时间:2026-08-25| 87人浏览过
原创

前言

Sublime Text 是否好用,往往不取决于“装没装插件”,而在于配置有没有真正贴合你的开发习惯。这份整理以 PHP 场景为主,把编辑器基础设置、代码检查、格式化规则和常用插件拆开说明,方便你快速判断哪些能直接沿用,哪些必须按本机环境调整。

Sublime Text 基础设置与 PHP 校验路径关系图
Sublime Text 基础配置重点用纸面卡片梳理主题、字体、换行和 PHP linter 路径之间的关系。

不少人把 Sublime Text 当作轻量编辑器用,但真到日常写代码时,顺手与否往往取决于配置细节。这份配置以 PHP 开发为主线,拆开说明编辑器本体设置、代码校验与格式化方案,以及插件清单各自承担的职责,方便你判断哪些可以直接照搬,哪些需要按本机环境替换路径。

编辑器基础设置:先把日常体验调顺

这部分是 Sublime Text 的核心用户配置,主要影响主题、字体、换行方式,以及代码检查插件的联动方式。原始配置如下:

{
    "SublimeLinter":
    {
        "linters":
        {
            "php":
            {
                "cmd": "F:\program\phpStudy\php\php-7.1.8-nts\php.exe"
            }
        }
    },
    "color_scheme": "Packages/User/SublimeLinter/Monokai (SL).tmTheme",
    "font_face": "Courier New",
    "font_size": 14,
    "ignored_packages":
    [
        "Vintage"
    ],
    "theme": "Soda Dark 3.sublime-theme",
    "update_check": false,
    "word_wrap": "auto"
}

几项关键设置可以分开看:

主题与字体

theme 使用的是 Soda Dark 3.sublime-theme,配合 Monokai (SL).tmTheme 颜色方案,整体偏深色界面,适合长时间盯代码。字体设为 Courier New,字号是 14,属于比较稳妥的默认组合。

PHP 语法检查路径

配置里给 SublimeLinter 单独指定了 PHP 可执行文件路径:

"cmd": "F:\program\phpStudy\php\php-7.1.8-nts\php.exe"

这一步的作用是让 linter 明确知道该调用哪一个 PHP 解释器。对于本地装了多版本 PHP,或者通过集成环境管理 PHP 的用户来说,这种显式指定路径的方式更稳定。需要注意的是,路径必须替换成你自己机器上的实际位置,否则检查功能不会生效。

其他日常项

ignored_packages 中禁用了 Vintage,说明这套配置不打算使用 Vim 模式。update_check 设为 false,可以减少更新提示干扰;word_wrap 设为 auto,则更适合阅读较长文本或文档类内容。

phpfmt 与插件分工示意图
PHP 格式化与插件分工把 PHP 格式化规则和相关插件职责拆开呈现,突出规范项、手动触发方式以及版本差异。

插件清单:这套环境装了哪些功能

安装的插件并不算少,但方向比较明确,重点集中在导航、格式化、文档生成和前端辅助上:

  • CTags
  • DeleteBlankLines
  • DocBlocker
  • Emmet
  • Git
  • HTML-CSS-JS Prettify
  • jQuery
  • Markdown Preview
  • phpfmt
  • SublimeLinter
  • SublimeLinter-php
  • Theme-Soda
  • SideBarEnhancements

如果按用途归类,大致可以分成四组:

代码导航与文件操作

CTags 和 SideBarEnhancements 都属于提高工程操作效率的插件。前者偏符号索引和跳转,后者主要补强侧边栏右键菜单,在处理文件、目录时更方便。

代码清理与排版

DeleteBlankLines、HTML-CSS-JS Prettify、phpfmt 负责不同层面的格式整理。一个是快速清理空行,一个偏前端资源格式化,另一个面向 PHP 代码规范。

文档和预览

DocBlocker 用来补齐注释块,Markdown Preview 负责 Markdown 预览,适合经常在编辑器里同时处理代码与说明文档的场景。

语言与框架辅助

Emmet、jQuery、SublimeLinter、SublimeLinter-php 则分别服务于前端输入增强、库提示和 PHP 语法检查。这也能看出,这套环境虽然以 PHP 为主,但并没有把前端工作完全拆到别的工具里。

DocBlocker:注释模板里补上作者和时间

如果你希望生成注释块时直接带上固定字段,DocBlocker 可以通过额外标签来完成。原配置如下:

{
  "jsdocs_extra_tags":[
      "@author   [Tech1024] <xxxxxx@163.com>",
      "@datetime {{datetime}}"
  ]
}

这里做了两件事:

  • 增加固定作者信息:@author [Tech1024] <xxxxxx@163.com>
  • 自动插入生成时间:@datetime {{datetime}}

这类配置适合团队内部要求保留注释头信息,或者个人希望统一文档风格的情况。是否保留邮箱、时间字段,要看你的协作习惯;如果只是个人项目,也可以继续精简。

phpfmt:把 PHP 格式化规则固定下来

这套配置里,PHP 格式化是另一项重点。对应的 phpfmt 设置如下:

{
  "autocomplete": true,
  "enable_auto_align": true,
  "format_on_save": false,
  "indent_with_space": 4,
  "option": "value",
  "passes":
      [
          "MergeElseIf"
      ],
  "php_bin": "F:/program/phpStudy/php/php-7.0.12-nts/php.exe",
  "psr1": true,
  "psr1_naming": true,
  "psr2": true,
  "version": 3
}

格式化风格

这里明确启用了 psr1、psr1_naming 和 psr2,说明配置目标是尽量贴近 PHP 常见规范。缩进使用 4 个空格,enable_auto_align 为 true,也符合大多数 PHP 项目的排版习惯。

是否保存时自动格式化

format_on_save 被设为 false。这意味着格式化不会在每次保存时自动执行,更适合不希望编辑器频繁改动代码、或者手动控制整理时机的用户。

PHP 可执行文件路径

php_bin 指向的是:

"php_bin": "F:/program/phpStudy/php/php-7.0.12-nts/php.exe"

这里与前面的 SublimeLinter 使用了不同版本的 PHP,一个是 php-7.1.8-nts,一个是 php-7.0.12-nts。从配置上看这是完全允许的,但实际使用时最好确认两者是否有意区分;如果没有特殊需求,统一版本通常更容易避免格式化与语法检查结果不一致的问题。

额外处理规则

passes 中启用了 MergeElseIf,表示格式化时会对 else if 结构做特定合并处理。虽然配置项不多,但已经足够体现这套环境偏向“规范优先、手动触发”的使用习惯。

这套 Sublime Text 配置适合什么人

如果你的工作流以 PHP 为主,同时又会顺手处理 HTML、CSS、JavaScript 和 Markdown,这套配置基本覆盖了常见需求:有主题和字体设置,有语法检查,有 PHP 格式化,也有注释生成和文件操作增强。

真正需要你按本机环境调整的,主要是两类信息:一类是 PHP 可执行文件路径,另一类是注释中的个人信息。除此之外,像 Theme-Soda、Emmet、Markdown Preview、SideBarEnhancements 这类插件,大多都可以直接作为轻量开发环境的常用组合参考。

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。