wordpress package是专为wordpress开发者设计的补全库,含2909+函数、2045+钩子、866+常量和类,覆盖wp 4.8.1核心,需通过原生sublime安装并正确配置php语法与package control方可生效。

直接装 WordPress Package 就行,别碰汉化整合包
它不是“增强插件”,而是专为 WordPress 开发者预编译的完整补全库——含 2909+ 函数、2045+ 钩子、866+ 常量和类,覆盖到 WordPress 4.8.1 核心。官方源已停更,但当前版本在 PHP 7.4–8.3 + ST3/ST4 下仍稳定可用。
常见错误是下载所谓“汉化版 Sublime + WordPress 插件打包包”。这类包往往篡改 Preferences.sublime-settings 或注入非标 .sublime-completions 文件,导致 register_post_type 补全时参数错位,或 add_action 的第 3 个参数($priority)被漏掉。
- 必须用原生 Sublime Text 安装(官网
sublimetext.com下载),不要用任何第三方“便携汉化激活版” - 安装后先确认右下角显示
PHP或HTML语法,不是Plain Text—— 否则补全不会触发 - 插件本身不提供中文函数说明,靠命名规范识别:比如输入
wp_会列出wp_insert_post、wp_redirect等;输入add_会弹出add_action、add_filter
Package Control 必须先装,且要用带校验的安装命令
很多用户卡在第一步:粘贴旧版无校验代码,结果 Package Control 显示已安装,但 Ctrl+Shift+P → Install Package 没反应。原因是 sublime.wbond.net 域名已失效,且旧脚本没做 SHA256 校验,容易因中间人劫持写入损坏文件。
正确做法(适用于 ST3/ST4):
import urllib.request,os,hashlib; h = '7183a2d3e96f11eeadd761d777e62404e330c659d4bb41d3bdf022e94cab3cd0'; pf = 'Package Control.sublime-package'; ipp = sublime.installed_packages_path(); urllib.request.install_opener(urllib.request.build_opener(urllib.request.ProxyHandler())); by = urllib.request.urlopen('https://packagecontrol.io/' + pf.replace(' ', '%20')).read(); dh = hashlib.sha256(by).hexdigest(); open(os.path.join(ipp, pf), 'wb').write(by) if dh == h else None
- 注意 URL 已从
sublime.wbond.net切换为packagecontrol.io - 执行后重启 Sublime Text,再按
Ctrl+Shift+P输入Install Package,等待状态栏显示 “Ready” 才可搜索 - 如果控制台报
urlopen error [SSL: CERTIFICATE_VERIFY_FAILED],说明系统 OpenSSL 版本太低,需手动下载Package Control.sublime-package放入Installed Packages/目录
装完 WordPress Package 后要手动启用 PHP 语法关联
插件默认只对 .php 文件生效,但 WordPress 主题里的 index.php、插件主文件常带 /* Plugin Name: ... */ 头,Sublime 可能误判为 Plain Text,导致 get_posts 完全不提示。
解决方法很简单:
- 打开任意一个 WordPress PHP 文件
- 点击右下角语法标识(如显示
Plain Text),选择PHP→PHP - 或按
Ctrl+Shift+P输入Set Syntax: PHP回车 - 想永久生效?在
Preferences → Settings – User里加这一行:"extensions": ["php", "php5", "inc", "module", "plugin"]
别忽略这步——否则你敲 wp_ 十次,光标只会闪烁,什么都不会弹出来。
Tab 键行为和废弃函数过滤是关键细节
这个插件最实用但最容易被忽略的机制是 Tab 导航:首次按 Tab 会选中全部参数占位符(比如 register_post_type( $post_type, $args ) 中两个参数都被高亮),再按一次才跳到第一个参数,第三次跳第二个。很多人不知道这点,狂按 Tab 把整个函数删了。
另外,它剔除了 219 个已废弃函数(如 wp_get_http),但如果你维护老项目(WP ≤ 3.9),可能需要回退到旧版插件,否则补全列表里根本找不到这些函数。
性能上基本无感,但开启后首次加载 .php 文件会有约 0.3 秒延迟——这是它在扫描当前文件是否含 wp-includes 路径引用,用来决定是否激活钩子补全。如果项目不含 WordPress 核心目录,它会自动降级为仅函数补全。











