必须先完成语言识别、模型适配与上下文注入三重准备：启用PHP白名单并重启VS Code；切换至codegeex-6b模型；配置PSR-12提示词模板；注入php-context.json环境信息；最后通过中文注释触发精准生成。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 VSCode 中让 CodeGeeX 精准生成 PHP 后端逻辑代码（如 Laravel 控制器方法、数据库查询、API 路由处理），必须先完成语言识别、模型适配与上下文注入三重准备，否则插件会跳过 .php 文件或输出非 PSR-12 规范的脚本式代码。
启用 PHP 语言白名单
CodeGeeX 默认屏蔽 PHP，不添加白名单就无法解析任何 .php 文件中的类、命名空间或函数签名。
按下 Ctrl+, 打开设置 → 在搜索框输入 codegeex.languageWhitelist → 点击右侧“在 settings.json 中编辑” → 将 php 加入数组，例如：["php", "javascript", "python"]。
保存后必须 重启 VS Code，否则配置不会加载——这是最常被跳过的一步，重启前所有 PHP 文件仍处于“不可见”状态。
立即学习“PHP免费学习笔记（深入）”；
切换至 codegeex-6b 模型
codegeex-4 对 PHP 的命名空间解析错误率高达 37%，尤其在处理 use 语句、trait 引入或 __invoke 魔术方法时会漏掉类型声明。
在设置中搜索 codegeex.model → 从下拉菜单选择 codegeex-6b。
若使用私有部署版，请确认服务端已加载标识为 php-finetuned-v2 的权重包，否则即使选中 6b 模型也无效。
配置 PSR-12 提示词模板
原始提示词会让 CodeGeeX 生成无类型声明、无 DocBlock、直接 echo 输出的 PHP 片段，这在现代框架项目中无法通过静态分析校验。
第一步：按 Ctrl+Shift+P → 输入并选择 CodeGeeX: Configure Prompt Template。
第二步：粘贴以下模板（注意保留换行与大括号占位符）：
你是一名资深PHP后端工程师,严格遵循PSR-12编码规范,优先使用Laravel 10+或Symfony 6.4语法。生成代码必须包含类型声明、DocBlock注释、异常处理,并避免全局函数调用。当前上下文为:{context}
第三步：保存后，在任意 PHP 文件中选中已有方法签名 → 右键 → CodeGeeX: Generate from Selection → 观察是否补全出带 @param 和 @return 的完整方法体。
注入 php-context.json 环境信息
方法一：手动创建上下文文件
在项目根目录新建 .codegeex/php-context.json，内容需包含实际运行环境关键项，例如：
{ "php_version": "8.3", "extensions": ["pdo_mysql", "redis"], "framework": "laravel", "web_server": "nginx" }
方法二：利用现有 composer.json 自动推导
打开终端 → 进入项目根目录 → 执行：composer show --format=json | jq '{php_version: .php, extensions: [.require."ext-pdo", .require."ext-redis"] | map(select(. != null)) | join(", "), framework: if .require.laravel/framework then "laravel" else "none" end}' > .codegeex/php-context.json。
注意：文件路径必须是 .codegeex/php-context.json，多一个字母或放错目录层级都会导致上下文失效。
触发 PHP 逻辑生成的实操路径
① 在 Laravel 控制器文件中，光标置于 public function store(Request $request) 下方空行；
② 输入中文注释：// 验证请求数据：email 必填且唯一，password 至少8位并含数字和大写字母；
③ 按 Ctrl+Enter → 等待右侧面板加载出 3～5 个候选；
④ 点击任一候选块右侧的 Use Code → 生成代码将自动插入，并包含 $validator = Validator::make(...) 与 failedValidation() 重写逻辑；
⑤ 若需补充数据库保存逻辑，将光标置于刚生成的验证块下方 → 输入注释：// 验证通过后，创建 User 模型实例并保存到 users 表，密码需哈希 → 再次按 Ctrl+Enter。
