在 Ubuntu 上，PhpStorm 的代码自动补全开箱即用，按下面步骤配置与高效使用即可。
快速开始与快捷键
- 确保已为项目配置 PHP 解释器：进入 Settings/Preferences > Languages & Frameworks > PHP，选择正确的 CLI Interpreter（常见路径如 /usr/bin/php）。解释器配置正确能显著提升补全的准确性与速度。
- 基本补全：在代码里输入部分字符后按 Ctrl + Space 呼出建议列表；继续输入可过滤，用方向键选择，回车插入。
- 智能补全：在建议列表可见时按 Ctrl + Shift + Space，会根据类型与上下文给出更精确的建议（如方法参数、返回值类型等）。
- 触发时机：在 Settings/Preferences > Editor > General > Code Completion 勾选 Autopopup code completion，即可边写边弹建议；可按需调整延迟与其他行为。
提升补全质量的关键设置
- 自动导入与去重：在 Settings/Preferences > Editor > General > Auto Import 勾选 Add unambiguous imports on the fly 与 Optimize imports on the fly，减少手动 use 与命名冲突，补全更顺畅。
- 使用 PHPDoc 增强类型推断：为函数、参数、返回值添加 @param、@return、@var 等注解，必要时用 @property-read/@method 描述动态成员，补全将更“懂”你的对象结构。
- 框架与静态分析增强：安装 Laravel/Symfony 等框架插件；结合 PHPStan/Psalm 做静态分析，生成更丰富类型信息，补全更精准。
常见问题排查
- 建议不出现或很慢：优先检查 PHP 解释器是否配置正确；在 Code Completion 中开启自动弹出并适当调整延迟；必要时增加 IDE 内存（编辑 bin/phpstorm64.vmoptions，如设置 -Xms128m -Xmx2048m），并关闭不必要插件以提升性能。
- 第三方库无提示：安装对应框架插件，并用 PHPStan/Psalm 增强类型信息；为关键类与方法补充 PHPDoc，补全会显著改善。
- WSL 或远程环境：在 CLI Interpreter 选择 From Docker, Vagrant, VM, WSL, Remote… > WSL，指向 WSL 中的 PHP 可执行文件，补全基于远端环境更准确。
高效输入的小技巧
- 善用 Live Templates：在 Settings/Preferences > Editor > Live Templates 为常用片段创建缩写（如 fore、logd、repo），输入缩写即可展开成完整代码块。
- 意图操作与快速修复：将光标置于代码元素上按 Alt + Enter，可执行引入类、生成方法/属性、提取变量/方法等上下文操作，常与补全配合能明显加速编码。