新建PHP文件默认注释由PHP File模板控制,路径为Settings→Editor→File and Code Templates→Files→PHP File;需用${...}格式调用变量(如${DATE}${USER}),改后须完全退出IDE再重启才生效。

新建 PHP 文件默认带的注释块(比如 Created by PhpStorm)不是“固定死的”,而是由 PHP File 模板控制的——改它就能彻底换掉开头那段注释,包括日期格式、作者名、甚至加 PSR-4 命名空间声明。
怎么找到并编辑 PHP File 模板
路径是 Settings → Editor → File and Code Templates → Files → PHP File(macOS 是 PhpStorm → Preferences)。别去 Includes 或 Other 标签页找,那里不生效。打开后你会看到默认内容类似:
/**<br> * Created by PhpStorm.<br> * User: ${USER}<br> * Date: ${DATE}<br> * Time: ${TIME}<br> */这就是你要动的地方。注意变量必须用 ${...} 包裹,写成 $DATE 或 $USER 会原样输出,不替换。
常见改法和容易踩的坑
想让新文件更贴近项目规范?这几个点最常出错:
立即学习“PHP免费学习笔记(深入)”;
-
${DATE}固定为YYYY/MM/DD格式,没法改成Y-m-d;真要自定义得靠${TIME}配外部脚本,模板层做不到 - 如果项目用 PSR-4,但你希望新建
.php文件时自动带namespace,光在模板里写namespace ${NAMESPACE};没用——${NAMESPACE}只在PHP Class模板里有效,PHP File模板里它永远为空 - 想删掉
Created by PhpStorm这行?直接删。但别只删文字留空行,否则生成文件会多一个空行——模板里每行回车都会被保留 - 改完不重启 PhpStorm,旧缓存还在,新建文件还是老样子;必须彻底退出进程再重开(macOS 右键 Dock 图标 → Quit,Windows 任务栏右键 → Close window)
为什么改了却没生效?验证方法
不是所有新建操作都走 PHP File 模板:
- 用 New → PHP File 才触发它;而 New → PHP Class 走的是
PHP Class模板,完全无关 - 模板里变量写错(比如漏了
${}的大括号),PhpStorm 会静默忽略,渲染成空白或字面量;可在模板里临时加一行// debug: ${NAME},新建文件看是否出现——没出现就说明模板根本没被调用 - 项目 PHP Language Level 设置低于 7.0 时,某些语法(如
declare(strict_types=1))会被自动过滤掉,即使你写进模板里也看不到
真正难处理的不是改模板,而是搞清哪个模板管哪件事:新建文件、新建类、新建接口、打代码片段……每个动作背后都是不同模板在驱动,混用就会白改。



















