PhpStorm中代碼模板的分類

在 PhpStorm 中，我們可以通過代碼模板功能快速生成初始化代碼，提高編碼效率。代碼模板分為兩種，一種是文件代碼模板，一種是代碼代碼片段模版。

我們先來看文件代碼模板。

1、文件代碼模版

通過 Command + Shift + A 調(diào)出 Action 導(dǎo)航界面，在輸入框輸入 templates，在下拉列表中選中「File and Code Templates」：

 

進(jìn)入文件代碼模板界面，在這里我們可以看到 PhpStorm 內(nèi)置支持的所有語言/框架的代碼模板：

 

當(dāng)我們通過 Command + Up 選擇指定目錄再通過 Command + N 創(chuàng)建新文件時(shí)，對應(yīng)的文件初始化代碼模板就定義在上圖的 File and Code Templates -> Files 列表中：

 

以新建 PHP Class 文件為例，對應(yīng)的類文件初始化代碼模板是：

<?php
#parse("PHP File Header.php")

#if (${NAMESPACE})

namespace ${NAMESPACE};

#end

class ${NAME} {

}

第一行代碼表示 PHP 腳本標(biāo)簽，第二行代碼用于引入 PHP 文件頭 PHP File Header.php，對應(yīng)的模板代碼在 Includes 標(biāo)簽頁下：

 

目前這里為空。

我們繼續(xù)回到 PHP Class 代碼模版，如果在創(chuàng)建新的類文件時(shí)指定了命名空間，則聲明對應(yīng)的命名空間。

最后，用 PHP 類名填充 class ${NAME} 中的 ${NAME}，完成 PHP 類文件的模板代碼生成。

其他文件代碼模板原理也是一樣，可以自行查看。

另外，我們可以對 PhpStorm 自帶的文件代碼模板進(jìn)行修改，也可以新增自定義的文件代碼模板：

 

代碼片段模版

文件代碼模板用于在創(chuàng)建文件時(shí)初始化對應(yīng)語言/框架的代碼骨架，此外，PhpStorm 還支持通過 Live Templates 功能在編寫具體業(yè)務(wù)代碼時(shí)快速生成模板代碼，比如控制結(jié)構(gòu)、異常捕獲、函數(shù)骨架、Vue 組件模塊等。Live Templates 就在 File and Code Templates 選項(xiàng)下面：

 

比如，我們可以通過 pubf 快速生成 public function 函數(shù)模板代碼，在某個(gè) PHP 類里面輸入 pubf，然后點(diǎn)擊 Tab 鍵（或者在鍵入的地方選擇下拉框中第一個(gè)列出的代碼提示），即可生成對應(yīng)的代碼函數(shù)代碼：

 

和文件代碼一樣，你也可以對自帶的 Live Templates 模板進(jìn)行修改，或者新增自定義的代碼模版，我們以一個(gè)前端表單輸入框?yàn)槔M(jìn)行演示。

自定義 Live Template 示例

你可以先新建一個(gè) Template Group：

 

然后在其中新建一個(gè) Live Template：

 

將其命名為 textfield，并在下面的輸入框中編寫對應(yīng)的模板代碼：

 

我們在模板代碼中定義了一些變量（通過 $...$ 定義），以便為不同的文本輸入框定義對應(yīng)的屬性和文本。

這里 NAME 變量通過前端輸入來填充，LABEL 變量則根據(jù) NAME 生成，點(diǎn)擊「Edit variables」編輯變量：

 

為 LABEL 變量應(yīng)用 capitalize(String) 函數(shù)，并設(shè)置字符串參數(shù)為 NAME，表示將 NAME 變量值首字母大寫為 LABEL 變量賦值：

 

點(diǎn)擊 OK 保存。應(yīng)用 textfield 更改，在代碼編輯器中選取一個(gè)表單片段，嘗試輸入 textfield，然后點(diǎn)擊 Tab 鍵自動生成對應(yīng) Input 輸入框模板代碼：

 

在紅色光標(biāo)處輸入 name，可以看到其他變量位置都會自動填充對應(yīng)的字符串：