Debian上phpstorm如何使用代码模板

在 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 语句中、注释中生效等。
• 变量与表达式：在模板变量上使用 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 与其他平台之间同步模板时特别方便。