在 CentOS 上使用 PhpStorm 代码模板
一 核心概念与入口
- PhpStorm 的代码模板分为两类:
- 文件代码模板 File and Code Templates:用于新建文件时生成骨架(如 PHP 类、接口、Trait 等)。
- 实时模板 Live Templates:在编辑器中输入缩写并按 Tab 展开为代码片段(如 try/catch、for 循环、函数骨架等)。
- 打开设置:依次点击 File → Settings(macOS 为 Preferences),常用入口为 Editor → File and Code Templates 与 Editor → Live Templates。在 CentOS 上界面与快捷键与 Windows/macOS 基本一致。
二 创建与使用文件代码模板
三 创建与使用实时模板
- 进入:File → Settings → Editor → Live Templates,选择或新建分组(如 PHP)。
- 新建模板:点击 + → Live Template,填写:
- Abbreviation(缩写,如:pubf、fori、tryc)
- Description(描述)
- Template text(模板内容,如:public function $METHOD$($PARAMS$)$RETURN_TYPE${END})
- 定义生效范围:点击 Define,勾选 PHP(或具体上下文,如 Statement、Expression)。
- 变量编辑:点击 Edit variables 配置变量顺序、默认值与表达式(如 capitalize())。
- 使用:在代码编辑区输入缩写(如 pubf、fori、tryc),按 Tab 展开;若未触发,检查缩写是否冲突及适用范围是否正确。
四 常用模板示例
- 函数骨架(pubf):
public function $METHOD$($PARAMS$)$RETURN_TYPE${END}
{
$END$
}
- for 循环(fori):
for ($i = 0; $i < $LIMIT$; $i++) {
$END$
}
- try/catch(tryc):
try {
$END$
} catch (Exception $e) {
// handle exception
}
- 变量与表达式:在 Edit variables 中可为 METHOD/NAME/LABEL 等变量设置默认值与函数(如 capitalize),实现联动填充。
五 排错与效率建议
- 模板不生效:确认已点击 Define 勾选 PHP 或相应上下文;检查缩写是否被其他模板占用;必要时重启 IDE。
- 变量顺序与光标:通过 Edit variables 调整 Order;使用 $END$ 指定展开后光标位置。
- 文件头统一:在 Includes → PHP File Header.php 维护公司/项目统一注释与版权信息。
- 快速生成方法:在类中右键 Generate…(或快捷键)可生成 Getter/Setter、构造方法、重写方法 等,与模板配合使用提升效率。