1. 为什么 PHP 项目在 VSCode 里总差一口气
VSCode 写 PHP 本身没问题，语法高亮、跳转、调试都能做，但真正让人卡住的是三件事：插件装了一堆却互相打架、PHP 可执行文件路径没配对导致 IntelliSense 直接罢工、以及 AI 补全的 Key 散落在各个插件里，换台机器就要重新配一遍。我见过太多人的 settings.json 是从某篇三年前的文章里抄来的，里面还写着terminal.integrated.shell.windows这种已经被新版 VSCode 废弃的字段，结果终端一开就报错。
这篇要解决的就是这条链路：插件怎么选、settings.json 怎么写、PHP 解释器路径怎么指、AI 补全的 Key 怎么用 TaoToken 统一收口，最后用一个真实的补全请求验证整条链路是通的。适合本地开发也适合远程 SSH 连到服务器上写 PHP 的人，因为配置骨架是同一套，只是路径和通道地址不同。
核心检索词先摆出来：VSCode PHP 插件配置、settings.json 骨架、TaoToken 统一 Key、AI 补全验证。你照着做，目标是打开一个.php文件就能看到函数签名提示，敲一半能出补全，并且这个补全走的是你自己配好的通道，而不是某个插件偷偷内置的默认地址。
2. TaoToken 前置：把 AI 补全的 Key 收口到一个地方
PHP 生态里带 AI 补全的插件不止一个，有的走 OpenAI 兼容格式，有的自己封装了一层。如果每个插件都单独填一次 Key，管理成本会很高，而且一旦要换模型或者换通道，就得挨个改。TaoToken 在这里的角色是一个统一的 API 通道：你拿一个 Key，配一个 base URL，所有支持 OpenAI 兼容接口的插件都指向它，模型切换在服务端做，客户端不用动。
官网入口在这里：https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，注册后进控制台拿 Key。API 地址是 https://taotoken.net/api ，注意这个地址不带任何查询参数，直接作为 base URL 用。
拿 Key 的路径是：控制台 → API Keys → 新建。建议给 VSCode 单独建一个 Key，命名成vscode-php-local之类，方便以后按用途吊销。Key 拿到后先别急着往 settings.json 里塞，因为有些插件不读 VSCode 的设置项，而是读环境变量，这个后面配置章节会分开处理。
模型对话的入口在 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，你可以先在那里试一下通道通不通，确认能出结果再往编辑器里配，这样排障的时候能少一层变量。如果你后面要跑长期编码或者 Agent 类的任务，Coding Plan 在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，那个是另一套计费逻辑，本篇只做本地补全，用按量 Key 就够。
3. 可复制配置：插件清单与 settings.json 骨架
3.1 插件清单，按职责分组
不要一次装二十个插件，PHP 开发真正需要的是下面这几类。装多了只会让启动变慢、补全打架。
| 类别 | 插件 | 作用 |
|---|---|---|
| 语言基础 | PHP Intelephense | 补全、跳转、签名提示，PHP 开发的核心 |
| 调试 | PHP Debug | 配合 Xdebug 断点调试 |
| 格式化 | phpfmt 或 PHP CS Fixer | 保存时自动格式化 |
| 路径 | Path Intellisense | 写require时补全文件路径 |
| 标签 | Auto Close Tag / Auto Rename Tag | 写模板时自动闭合与重命名 |
| 图标 | vscode-icons | 文件类型图标，纯观感 |
| AI 补全 | Continue 或同类 OpenAI 兼容插件 | 走 TaoToken 通道做行内补全 |
PHP Intelephense 和 PHP Intellisense 不要同时装，两者都做补全，会抢同一个触发时机，表现就是提示框闪一下又消失。保留 Intelephense 即可，它对现代 PHP 支持更好。
3.2 settings.json 骨架
打开方式：文件 → 首选项 → 设置 → 右上角打开 settings.json。下面这份是可以直接粘的骨架，路径部分按你自己的环境改。
{ "php.validate.executablePath": "D:\\phpstudy_pro\\Extensions\\php\\php8.2\\php.exe", "intelephense.environment.phpVersion": "8.2.0", "intelephense.files.maxSize": 5000000, "editor.wordWrap": "on", "editor.formatOnSave": true, "breadcrumbs.enabled": true, "files.associations": { "*.php": "php" }, "path-intellisense.autoSlashAfterDirectory": true, "terminal.integrated.defaultProfile.windows": "Git Bash", "taotoken.baseUrl": "https://taotoken.net/api", "taotoken.apiKey": "sk-你的Key", "taotoken.model": "claude-sonnet-4-20250514", "continue.enableTabAutocomplete": true }几个字段说明一下。php.validate.executablePath和intelephense.environment.phpVersion必须一致，否则你本地跑的是 8.2，插件按 7.4 的语法提示，会出现明明能跑的代码被标红。terminal.integrated.defaultProfile.windows是新版写法，老文章里的terminal.integrated.shell.windows已经废弃，写了会报 unknown configuration。
taotoken.baseUrl和taotoken.apiKey这两个字段名取决于你用的 AI 插件，Continue 的话是写在它自己的config.json里，不是 VSCode 的 settings.json。下面给一份 Continue 的配置，路径在~/.continue/config.json。
{ "models": [ { "title": "TaoToken", "provider": "openai", "model": "claude-sonnet-4-20250514", "apiBase": "https://taotoken.net/api", "apiKey": "sk-你的Key" } ], "tabAutocompleteModel": { "title": "TaoToken Autocomplete", "provider": "openai", "model": "claude-sonnet-4-20250514", "apiBase": "https://taotoken.net/api", "apiKey": "sk-你的Key" } }注意apiBase填的是https://taotoken.net/api，不要在后面加/v1或者/chat/completions，插件会自己拼路径。加了反而会 404。
3.3 远程项目的路径处理
如果你用 Remote-SSH 连服务器写 PHP，php.validate.executablePath要填服务器上的路径，比如/usr/bin/php，而不是你本机的 Windows 路径。Intelephense 的environment.phpVersion也要跟服务器一致。这一点很容易踩坑：本地配好了，连上远程发现补全全废，就是因为路径还指着D:\。
4. 验证请求：确认补全真的走通了
配置写完不要靠感觉，用一个具体动作验证。新建一个test.php，输入下面这段：
<?php $arr = [3, 1, 2]; sort($arr); echo implode(',', $arr);把光标放在sort后面，按Ctrl+Space手动触发补全。如果 Intelephense 正常工作，你会看到sort的函数签名提示，参数类型是array &$array。这一步验证的是语言服务，跟 AI 无关。
接着验证 AI 补全。在文件末尾新起一行，输入注释：
// 写一个函数，接收数组，返回去重后按升序排列的结果然后回车，等 Continue 的行内补全触发。正常情况下会生成类似这样的代码：
function uniqueSorted(array $input): array { $input = array_unique($input); sort($input); return $input; }如果补全没出来，先看 Continue 的输出面板（输出 → 选 Continue），里面会打印请求的 URL 和状态码。状态码 401 是 Key 不对，404 是 base URL 拼错了，429 是额度或频率问题。这一步能直接定位是通道问题还是插件问题。
想再确认一次通道本身是通的，可以脱离编辑器直接打一发请求：
curl https://taotoken.net/api/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-你的Key" \ -d '{ "model": "claude-sonnet-4-20250514", "messages": [{"role": "user", "content": "用一句话说明 PHP 的 array_unique 做什么"}] }'返回里有choices字段就说明 Key 和通道都没问题，剩下的是插件配置的事。这个 curl 我建议你留着，以后换机器或者换 Key 的时候先跑它，能省很多排查时间。
5. 本篇常见错排查
5.1 Intelephense 提示 "PHP executable not found"
九成是php.validate.executablePath路径写错，或者路径里有空格没转义。Windows 下反斜杠要写成双反斜杠\\。另一个可能是你装了 PHP Intellisense，两个插件抢着读这个字段，禁掉其中一个再重载窗口。
5.2 补全出来了但全是过时语法
检查intelephense.environment.phpVersion和你实际跑的 PHP 版本是否一致。如果你本地是 8.2，这里写的 7.4，那readonly、枚举这些新语法会被标红，而一些废弃函数反而被提示。改完记得Ctrl+Shift+P→ Reload Window。
5.3 AI 补全一直转圈不出结果
先看输出面板的请求日志。如果请求根本没发出去，是插件没启用行内补全，Continue 里要确认tabAutocompleteModel配了。如果发出去了但超时，检查apiBase是不是多写了/v1。还有一种情况是模型名写错，服务端返回 400，日志里能看到model not found，换成控制台里列出的可用模型名即可。
5.4 保存时格式化把代码改乱
editor.formatOnSave开了但没指定 formatter，VSCode 会用默认的，可能跟你的风格冲突。明确指定："[php]": { "editor.defaultFormatter": "bmewburn.vscode-intelephense-client" }，或者用 phpfmt 并配好phpfmt.php_bin。格式化工具和 PHP 版本不匹配也会出怪问题，比如 8.2 的代码用 7.4 的 formatter 跑，会报语法错误。
5.5 远程 SSH 下补全失效
本地 settings.json 里的路径在远程不适用。Remote-SSH 场景下，工作区设置（.vscode/settings.json放在项目根目录）优先级高于用户设置，把 PHP 路径和版本写在工作区设置里，这样本地和远程可以各配各的。
6. 把 Key 和通道固定下来，后面就省事了
配置这件事一次做对，后面换项目、换机器都是复制粘贴。我的做法是把settings.json里跟机器相关的部分（PHP 路径、终端 profile）和跟通道相关的部分（base URL、Key）分开记，前者每台机器改一次，后者用同一个 TaoToken Key 走天下。Key 的管理入口在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，需要轮换或者给不同项目分 Key 的时候去那里操作。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，里面列了兼容的接口格式和模型名，配插件之前扫一眼能少走弯路。
最后留一个实用习惯：每次改完 settings.json，先跑一遍第 4 节那个 curl，再回编辑器触发一次补全。两步都过，这条链路就是稳的。
