VSCode+CodeGeeX自动生成PHP后端代码实战指南
要在VS Code中利用CodeGeeX精确生成PHP后端代码，特别是Laravel控制器方法、数据库查询和API路由这类逻辑，必须遵循一套固定工作流。跳过预处理步骤，插件要么对.php文件完全无响应，要么输出大量不符合PSR-12规范的零散脚本——连命名空间和类型声明都会缺失。
在用中文注释驱动生成之前，有三项准备工作必须完成：语言识别、模型适配、环境上下文注入。任何一项缺失，生成的代码都可能出现严重偏差。
启用 PHP 语言白名单
坦白讲，CodeGeeX默认并未开启PHP支持。若不手动将其加入白名单，插件根本不会解析.php文件中的类、命名空间或函数签名——并非插件“看不见”，而是它“不认”。
解决方法很简单：按 Ctrl+, 打开设置，搜索 codegeex.languageWhitelist，点击“在settings.json中编辑”，将PHP添加进去。格式如 ["php", "javascript", "python"]，可按需调整。
保存后务必重启VS Code。这是最容易忽略却最关键的一步。不重启，配置不会生效，所有PHP文件对插件而言仍处于“不可见”状态——很多开发者在此处卡住却找不到原因。
切换至 codegeex-6b 模型
实测表明，codegeex-4对PHP命名空间的解析错误率高达约37%。尤其在处理use语句、trait引入或__invoke魔术方法时，经常遗漏类型声明。这在现代PHP项目中根本无法通过编译。
前往设置搜索 codegeex.model，从下拉菜单中选择codegeex-6b。
若使用私有部署版本，还需确认服务端已加载标记为 php-finetuned-v2 的权重包。仅选择6b模型但权重不匹配，依然无效。
配置 PSR-12 提示词模板
默认提示词生成的PHP代码大多缺少类型声明、DocBlock注释，甚至直接输出echo。这类片段放入Laravel或Symfony项目中，连静态分析都无法通过。
你需要重新告知插件：我需要符合现代规范的代码。
第一步：按 Ctrl+Shift+P，输入并选择 CodeGeeX: Configure Prompt Template。
第二步：将以下模板粘贴进去（注意保留换行和大括号占位符）：
你是一名资深PHP后端工程师,严格遵循PSR-12编码规范,优先使用Lara vel 10+或Symfony 6.4语法。生成代码必须包含类型声明、DocBlock注释、异常处理,并避免全局函数调用。当前上下文为:{context}
第三步：保存后，打开一个PHP文件测试——随便选中一个现有方法签名，右键选择CodeGeeX: Generate from Selection。若补全内容包含@param和@return，说明提示词已生效。
注入 php-context.json 环境信息
这一步常被忽略，却决定了插件生成的代码是否针对你的实际环境优化。PHP版本、扩展安装情况、使用框架、Web服务器类型……若补全模型不知道这些信息，只能猜测，而猜测结果往往偏差很大。
有两种方式注入环境信息：
方法一：手动创建上下文文件
在项目根目录新建 .codegeex/php-context.json，内容需包含真实环境关键项，例如：
{ "php_version": "8.3", "extensions": ["pdo_mysql", "redis"], "framework": "lara vel", "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.lara vel/framework then "lara vel" else "none" end}' > .codegeex/php-context.json
硬性要求：文件路径必须为 .codegeex/php-context.json，多一个字母或放错目录层级，上下文均不会生效。踩过几次坑后自然会记住。
触发 PHP 逻辑生成的实操路径
准备工作完成后，最终要落到实际编码场景。以下是一套稳妥的操作流程：
① 打开一个Laravel控制器文件，将光标移到 public function store(Request $request) 方法下方的空行；
② 输入中文注释——CodeGeeX对中文注释的识别准确度较高，例如：// 验证请求数据：email 必填且唯一，password 至少8位并含数字和大写字母
③ 按 Ctrl+Enter，等待右侧面板加载3到5个候选代码块；
④ 选择所需的候选块，点击右侧的 Use Code，生成的代码会自动插入——通常会自带 $validator = Validator::make(...) 和 failedValidation() 重写逻辑，省心不少；
⑤ 如需补充数据库保存逻辑：将光标移至刚生成的验证块下方，再写一条注释——// 验证通过后，创建 User 模型实例并保存到 users 表，密码需哈希，然后再次按 Ctrl+Enter。
逐段生成，代码质量和上下文连贯性会显著提升。整套流程熟练后，PHP后端的代码补全效率确实能迈上一个台阶。