CodeGeeX 对 PHP 支持良好但依赖 PHPDoc 注释推断意图，需明确写 @param 和 @return；解释代码须选中完整逻辑块；翻译和测试生成需手动校验上下文兼容性与配置。
CodeGeeX 对 PHP 支持良好，但默认行为容易忽略函数签名和上下文约束，直接用会生成不可用代码。
PHP 函数补全必须写清楚参数和返回值注释
CodeGeeX 的 inlineCompletionProvider.ts 依赖 JSDoc / PHPDoc 风格注释推断意图。没写 @param 和 @return，它大概率按通用模板生成，比如把 array 当成默认返回类型，而实际你需要 string|null。
- 错误写法：
function formatUser($user) {—— 补全结果常漏判空、无类型约束 - 推荐写法：在函数上方加完整 PHPDoc，例如：
/** * @param array $user * @return string|null */
- 触发补全前，光标停在
{后，再按Tab或Ctrl+Enter，效果更准
用 CodeGeeX 解释遗留 PHP 代码时，要选中完整逻辑块
单行或零散语句解释往往只输出字面意思，比如 foreach ($arr as $k => $v) 只被说成“遍历数组”，但选中整个循环体 + 内部条件判断后，它能识别出“这是去重并合并用户配置的逻辑”。
- 选中范围建议包含：入口调用、关键变量赋值、条件分支、返回语句
- 避免只选中
if (isset($data['id']))这类片段——它不会告诉你这个$data是从哪来的 - 解释模式快捷键是
Alt+T，模板选explanation，不是直接输入文字提问
翻译 PHP 到其他语言时，注意魔术方法和扩展函数兼容性
Ctrl+Alt+T 翻译看似一键完成，但 PHP 特有机制（如 __get、json_encode()、mysqli_*）在目标语言中没有直接对应物，CodeGeeX 有时会硬映射成不安全或低效实现。
立即学习“PHP免费学习笔记（深入）”；
- 常见坑：
$_SESSION被直译成 Python 的session模块，但没处理启动逻辑；date('Y-m-d')译成 JS 的toISOString().split('T')[0]，却忽略时区问题 - 建议先用
Ctrl+Alt+T得到初稿，再手动检查三类内容：$_SERVER相关变量、数据库操作、文件/目录路径函数 - 若目标语言是 Python，优先让它生成基于
flask.session或django.contrib.sessions的结构，而不是裸 dict 操作
生成 PHP 单元测试要主动指定框架和覆盖率边界
CodeGeeX 默认生成 PHPUnit 测试，但它不会自动读取你项目里的 phpunit.xml 配置，比如是否启用 coverage、mock 规则、数据提供器路径。结果常出现 Class 'Mockery' not found 或断言覆盖不全。
- 在提示里明确写：“用 PHPUnit 10.x，mock 所有外部 API 调用，覆盖所有 if 分支”
- 生成后检查
use语句是否匹配你项目的 autoloader（如App\Services\UserService是否被正确引入） - 如果项目用 Pest，别指望它自动适配——目前插件未内置 Pest 模板，需手动改写
it('should...')结构
真正卡住 PHP 开发者的，从来不是语法，而是上下文隐含规则：某个函数必须在 session_start() 后调用、某个类必须继承特定基类、某个数组键名是硬编码在第三方 SDK 里的。CodeGeeX 不会主动问你这些，它只响应你给的文本信号。所以，多一行精准注释，比多按十次 Alt+[ 更有效。
