在 Debian 上,PhpStorm 的代码模板使用与系统无关,菜单路径与快捷键与 Windows/macOS 一致。下面按两种常用模板类型给出操作步骤与示例。
一 文件代码模板
- 打开设置:依次点击 File → Settings → Editor → File and Code Templates(macOS 为 Preferences)。
- 选择 Files 标签,点击 + 新建模板,填写名称与扩展名(如 PHP Class 对应扩展名 php),在模板主体中编写骨架代码。
- 可使用变量与指令:
- 作用范围与存储:模板可在 项目级 或 全局(默认) 配置;全局模板位于 IDE 配置目录的 config/fileTemplates,项目模板位于 .idea/fileTemplates,便于团队共享。
- 使用:通过 File → New 创建对应类型文件时自动生成模板内容。
二 Live Templates 实时模板
- 打开设置:File → Settings → Editor → Live Templates,选择目标语言(如 PHP)。
- 新建模板:点击 + → Live Template,设置:
- Abbreviation(缩写,如:pubf、fori、tryc)
- Description(描述)
- Template text(模板内容)
- 点击 Define 勾选生效上下文(如 PHP 语句、注释等)
- 变量与表达式:在模板变量上使用 Edit variables 配置表达式,例如对变量应用 capitalize(String) 函数,实现自动首字母大写。
- 使用:在编辑器中输入缩写(如 pubf),按 Tab 展开;常用示例:
- pubf → public function …
- fori → for ($i = 0; $i < …; $i++) { … }
- tryc → try { … } catch (Exception $e) { … }
- 提示:输入缩写后也可用代码补全选择展开项。
三 常用变量与指令速查
- 变量:${PROJECT_NAME}、${FILE_NAME}、${NAME}、${USER}、${DATE}、${TIME}、${YEAR}、${MONTH}、${DAY}、${HOUR}、${MINUTE}、${PRODUCT_NAME}、${MONTH_NAME_SHORT}、${MONTH_NAME_FULL}。
- PHP 包含模板专用:${CLASS_NAME}、${NAMESPACE}、${STATIC}、${TYPE_HINT}、${PARAM_DOC}、${THROWS_DOC}、${DS}(输出字面量 $)、${CARET}(生成后光标位置)。
- 指令:#parse(“模板名”) 引入包含模板;#set($var = “值”) 定义自定义变量。
四 团队共享与迁移
- 共享方式:将模板保存在 项目级(.idea/fileTemplates)便于纳入版本控制;若需在所有项目使用,放在 全局级(config/fileTemplates)。
- 导入导出:可在设置页面使用 Import/Export 进行模板备份与迁移,便于在 Debian 与其他平台间同步。