2026年04月26日
OTTAN.JP
iPhone · Mac · Windows Tips
Blog

【2026年版】VS Code(とCursor)でWordPressのテーマ・プラグインを開発するための拡張機能

By ottanjp 4 min read 更新 2026.04.21

🔁 2026年リライト版 この記事は2018年7月に公開した「【随時更新】VS CodeでWordPressのテーマやプラグインを開発するために導入したいオススメの拡張機能」を、2026年時点の拡張機能ラインナップとCursor/AI支援開発の動向を踏まえて全面書き換えしたものです。

2018年当時のラインナップ(PHP IntelliSense、WordPress Toolbox、phpcs拡張、Live Server 等)はほぼ非推奨または開発停止になり、2026年現在は別の組み合わせが定番になっています。また、VS Codeのフォークである Cursor もWordPress開発者の間で定着しつつあるため、両対応の視点で紹介します。

2018年との違い(ダイジェスト)

項目 2018年時点 2026年時点
PHP補完 PHP IntelliSense(Felix Becker、開発停止) PHP Intelephense(有償ライセンスは$15一括)
WP関数補完 WordPress Toolbox / WordPress Snippet WordPress Hooks IntelliSense(johnbillion)+ Intelephense
コーディング規約 phpcs 拡張(開発停止気味) PHP Sniffer & Beautifier or 組み込み
デバッグ PHP Debug(Felix Becker) PHP Debug(Xdebug 3.x対応、現役)
整形 PHP Formatter PHPCBF(PHPCSに同梱)
AI補助 なし GitHub Copilot or Cursorの組み込みAI

必須の拡張機能(2026年)

1. PHP Intelephense

bmewburn.vscode-intelephense-client

2026年時点のPHP開発は実質これ一択です。プロジェクト全体をインデックスし、関数・クラス・変数の定義箇所を即座に解決します。WordPressコアのファイルも自動で認識し、the_content()get_post_meta() のシグネチャを補完してくれます。

無料版でも十分使えますが、Premium($15 一括購入) にすると「名前の変更(Rename)」「未使用コードの削除」「ブック検索」などが解放されます。プロで使うなら買い切りの価値は高いです。

settings.json で VS Code 組み込みの PHP サポートと競合を避ける設定を入れます。

{
  "php.suggest.basic": false,
  "php.validate.enable": false,
  "intelephense.environment.phpVersion": "8.3.0",
  "intelephense.stubs": [
    "apache", "bcmath", "bz2", "calendar", "com_dotnet", "Core",
    "ctype", "curl", "date", "dba", "dom", "enchant", "exif",
    "FFI", "fileinfo", "filter", "fpm", "ftp", "gd", "gettext",
    "gmp", "hash", "iconv", "imap", "intl", "json", "ldap",
    "libxml", "mbstring", "meta", "mysqli", "oci8", "odbc",
    "openssl", "pcntl", "pcre", "PDO", "pdo_ibm", "pdo_mysql",
    "pdo_pgsql", "pdo_sqlite", "pgsql", "Phar", "posix", "pspell",
    "random", "readline", "Reflection", "session", "shmop",
    "SimpleXML", "snmp", "soap", "sockets", "sodium", "SPL",
    "sqlite3", "standard", "superglobals", "sysvmsg", "sysvsem",
    "sysvshm", "tidy", "tokenizer", "xml", "xmlreader", "xmlrpc",
    "xmlwriter", "xsl", "Zend OPcache", "zip", "zlib", "wordpress"
  ]
}

最後の "wordpress" がポイント。Intelephense はWordPress用のスタブ(型情報)を組み込みで持っているので、この1行で主要な関数が補完対象になります。

2. WordPress Hooks IntelliSense

johnbillion.vscode-wordpress-hooks

add_action()add_filter() のフック名を補完してくれる拡張。コア開発者 John Blackbourn 本人が公開しているため、WordPress本体のバージョンアップに追従する速度が最速です。

3. PHP Debug

xdebug.php-debug

Xdebug を用いたステップ実行デバッグの定番。2020年頃にFelix Becker氏のリポジトリから Xdebug 公式が引き継ぎ、Xdebug 3.x に完全対応しています。

Docker Compose 環境で使う場合、PHPコンテナに Xdebug を入れ、.vscode/launch.json に以下のような設定を入れます。

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Listen for Xdebug (Docker)",
      "type": "php",
      "request": "launch",
      "port": 9003,
      "pathMappings": {
        "/var/www/html": "${workspaceFolder}"
      }
    }
  ]
}

Xdebug 3 はデフォルトポートが 9003(2 系は 9000)である点に注意。

4. PHP Sniffer & Beautifier

valeryanm.vscode-phpsab

PHPCS(PHP_CodeSniffer)をVS Code内で走らせる拡張。2018年当時の ikappas.phpcs 拡張は開発停止状態なので、こちらに乗り換えます。

別途、WordPress Coding Standards(WPCS)を Composer でプロジェクトに導入します。

❯ composer require --dev wp-coding-standards/wpcs dealerdirect/phpcodesniffer-composer-installer

プロジェクトルートに phpcs.xml.dist を置き、<rule ref="WordPress" /> などを記述すればOKです。

5. GitHub Copilot / Cursor の組み込みAI

2023年以降に急速に普及した AI コード補完は、2026年には実務の標準装備になっています。WordPress開発では、

  • フック名・アクション名の推測補完
  • $wpdb の安全なプレースホルダー記述
  • noncecapability の確認漏れの指摘
  • プラグインのREADME自動生成

などで特に効果を発揮します。VS Code を使うなら GitHub Copilot、AI中心のワークフローなら Cursor という選択です。

参考

Comments
comments powered by Disqus