在 Debian 上使用 PhpStorm 时,代码模板的配置逻辑与 Windows、macOS 完全一致,菜单路径和快捷键也都没有差别。换句话说,只要你熟悉其他平台上的操作,在 Debian 上基本可以无缝迁移。下面针对两种最常用的模板类型,给出具体的操作步骤和示例,方便你直接上手。

一、文件代码模板
先看文件级别的模板,也就是当你通过 File → New 创建新文件时自动生成的骨架代码。
- 打开设置:File → Settings → Editor → File and Code Templates(macOS 对应 Preferences)。
- 选择 Files 标签页,点击加号新建模板。填写名称和扩展名,例如 PHP 类对应
php扩展名,然后在模板主体中编写你想要的骨架代码。 - 模板中可以使用预定义变量和指令:
- 常用变量:
${PROJECT_NAME}、${FILE_NAME}、${NAME}、${USER}、${DATE}、${TIME}、${YEAR}等。 - 包含指令:
#parse(“PHP File Header.php”)用于引入公共头部;在 Includes 标签页中可以维护可复用的片段。 - 举个例子(PHP 类模板):
#parse("PHP File Header.php") #if (${NAMESPACE}) namespace ${NAMESPACE}; #end class ${NAME} { }
- 常用变量:
- 作用范围与存储:模板可以配置为项目级或全局级(默认是全局)。全局模板存放在 IDE 配置目录下的
config/fileTemplates,项目级模板存放在.idea/fileTemplates,后者可以纳入版本控制,方便团队统一。 - 使用方式:当你通过 File → New 创建对应类型的文件时,PhpStorm 会自动用你设置好的模板内容填充。
二、Live Templates 实时模板
相比文件模板,Live Templates 更灵活——它让你在编辑器中输入简短的缩写,然后一键展开成完整的代码片段。
- 打开设置:File → Settings → Editor → Live Templates,然后选择目标语言(比如 PHP)。
- 新建模板:点击加号 → Live Template,需要配置以下几个关键项:
- Abbreviation(缩写):比如
pubf、fori、tryc。 - Description(描述):简要说明这个模板是干什么用的。
- Template text(模板内容):写出展开后完整的代码。
- 点击 Define 勾选生效上下文,例如在 PHP 语句中、注释中生效等。
- Abbreviation(缩写):比如
- 变量与表达式:在模板变量上使用 Edit variables 可以配置表达式,比如对变量应用
capitalize(String)函数实现自动首字母大写。 - 使用方式:在编辑器中输入缩写(如
pubf),然后按 Tab 键即可展开。常用示例包括:pubf→public function …fori→for ($i = 0; $i < …; $i++) { … }tryc→try { … } catch (Exception $e) { … }
- 小提示:输入缩写后也可以利用代码补全功能选择对应的展开项,不只是 Tab 键一种方式。
三、常用变量与指令速查
- 通用变量:
${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 与其他平台之间同步模板时特别方便。