PhpStorm怎么让新建文件自动套用模板-webstorm-PHP中文网

新建文件不套用模板是因为入口选错：New→PHP File仅用PHP File模板（${NAMESPACE}恒为空），New→PHP Class才用PHP Class模板（需目录设为Sources Root且含#parse指令），New→File手动输扩展名则走纯文本模板。

phpstorm怎么让新建文件自动套用模板

新建文件不套用模板，基本是因为你点错了入口——右键 New → PHP File 走的是 PHP File 模板，而 New → PHP Class 才走 PHP Class 模板。两者变量、结构、生效条件全不同，混用就白配。

PhpStorm 里“新建文件”有至少三种行为，对应三类模板：

New → PHP File：只读 PHP File 模板（位于 Files 标签下），支持 ${DATE}、${USER}，但 ${NAMESPACE} 永远为空
New → PHP Class：读 PHP Class 模板，能解析 ${NAMESPACE}，但前提是目录已标记为 Sources Root
New → File 后手动输 xxx.php：走默认文本模板，不触发任何 PHP 变量解析

常见错误是改了 PHP Class 模板，却用 New → PHP File 创建，结果发现 ${NAMESPACE} 没渲染、${NAME} 是空的——不是模板坏了，是根本没调用它。

${NAMESPACE} 不是靠猜出来的，它依赖两个硬性条件同时满足：

模板第一行必须保留 #parse("PHP File Header.php") —— 这是 PhpStorm 唯一识别命名空间推导的钩子，删掉或注释掉就失效
对应目录（如 src/）必须右键 → Mark Directory as → Sources Root，且点击 Apply（只点 OK 不生效）
改完必须重启 PhpStorm —— 缓存不刷新，${NAMESPACE} 就一直显示为字面量

验证方法：新建一个空 .php 文件，写，运行看输出。为空？上面三点至少漏了一项。

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

默认没有独立的 PHP Interface 或 PHP Trait 模板。你点 New → PHP Interface，IDE 实际复用的是 PHP Class 模板，所以生成的是 class XxxInterface —— 语法合法但语义错误。

进 Settings → Editor → File and Code Templates → Files，点击 + → Template Group 新建分组（如 PHP Contracts）
在该分组下新建模板，名称填 PHP Interface，扩展名留空，内容写：
```
interface ${NAME} {
}
```
同理建 PHP Trait 模板，内容为：
```
trait ${NAME} {
}
```
删掉所有 extends、implements、public function 等类专属结构

别用 ${CLASS_NAME} —— 这是弃用变量，${NAME} 才是当前文件名（不含 .php）的正确写法。

${DATE} 和 $USER$ 看似简单，但错一个字符就原样输出：

必须用 ${DATE}，不是 $DATE$ 、${date} 或 ${YEAR} —— 后者跨年不更新，且解析不稳定
${DATE} 格式固定为 2026/10/08，无法改成 2026-10-08；如需该格式，只能拼 ${YEAR}-${MONTH}-${DAY}
$USER$ 取操作系统用户名，不是 Git 用户名；要填 git config --get user.name，得加 JVM 参数 -Dgit.user.name=xxx，模板里用 $git_user_name$
所有变量必须严格包裹在 ${} 内，多一个空格、少一个 $，就当普通文本输出