在 Laravel 或 ThinkPHP 项目中使用 Fitten Code 编写 PHP 代码时，你是否遇到过代码补全不准确、模型字段始终无法提示、$this-> 后面一片空白的情况？别着急，这通常不是插件本身的问题，而是框架的上下文未能被正确识别。
那么，如何让 Fitten Code 在各类 PHP 框架中实现精准的代码自动补全呢？下面直接分享实用方法。
Fitten Code 在 Laravel 中启用精准补全
首先确认 VSCode 中已安装 PHP Intelephense 和 Fitten Code 两个扩展，它们缺一不可。Intelephense 负责 PHP 底层的语义分析，Fitten Code 则依赖它来提供上下文感知的 AI 建议，两者协同工作才能达到最佳效果。
接下来，在 Laravel 项目的根目录下依次执行以下命令，生成 IDE 辅助文件：
composer require --dev barryvdh/laravel-ide-helper → php artisan ide-helper:generate → php artisan ide-helper:models
执行完成后，检查项目根目录是否生成了 _ide_helper.php 和 _ide_helper_models.php 两个文件。需要特别留意的是，如果缺少 _ide_helper_models.php，Fitten Code 将无法补全数据库字段，例如 $user->name 或 $post->created_at 等提示都会完全失效。
最后，重启 VSCode，打开任意控制器，在 index() 方法中输入 $this->，稍等片刻——此时应能弹出当前控制器的所有 public 方法及父类方法；输入 User:: 后，find()、where() 等 Eloquent 静态方法也应能完整列出。
Fitten Code 在 ThinkPHP 中启用基础补全
ThinkPHP 原生不提供 IDE Helper 机制，因此 Fitten Code 对它的支持相对较弱，但通过一些最小化配置，仍然可以激活基本功能。
方法一：确保项目使用的是 ThinkPHP 6.3 或更高版本，并已执行过 composer install。Fitten Code 能够识别 Db::、Cache:: 这类门面类的静态方法，但仅限 think/helper 包中明确导出的类。
方法二：手动创建 _ide_helper_tp.php 文件，内容写入 。保存后，在任意 PHP 文件中输入 $Db->，即可触发基础的查询构造器方法补全。
方法三：如果前两种方法效果不佳，可以尝试禁用 Fitten Code 的“严格框架模式”。具体操作是：进入 Fitten Code 设置 → Language Support → PHP → 取消勾选「Enforce Laravel/TP context」。这样一来，补全会退回到通用的 PHP 函数级推荐，虽然不那么精准，但胜在稳定可用。
统一排查：为什么 Fitten Code 在两个框架中都补全失败
如果你遇到了补全失败的问题，可以从以下几个方向逐一排查：
首先，确认当前打开的 VSCode 窗口是否以 Laravel 或 ThinkPHP 项目根目录作为工作区。如果只是打开了单个 .php 文件，而没有打开整个文件夹，Fitten Code 将无法加载 composer.json 和框架的自动加载规则，补全必然失效。
其次，在终端运行 php -v 检查 PHP 版本。Laravel 要求 PHP ≥ 8.1，ThinkPHP 6.3 要求 PHP ≥ 8.0。Fitten Code 的 PHP 解析器会主动跳过版本低于最低要求的项目上下文索引。
另外，在 VSCode 的命令面板（Ctrl+Shift+P）中执行「Intelephense: Refresh Index」，强制重载 PHP 符号表。这一步对于刚拉取 Git 仓库或新增模型后的补全恢复非常关键。
最后，检查是否安装了其他 PHP 语言服务插件（如 PHP Tools、PHP Intellisense）。这些插件会与 Intelephense 发生冲突，导致 Fitten Code 接收到错误的 AST 节点。建议将它们全部关闭，只保留 Intelephense 和 Fitten Code。