declare(strict_types=1)必须置于PHP文件首行（

PhpStorm 本身不“开启 PHP 严格模式”，declare(strict_types=1) 是 PHP 解释器的运行时行为，由你写的代码控制——IDE 只负责识别、提示和协助你正确使用它。

怎么在文件里正确启用 strict_types

严格模式不是 PhpStorm 的设置项，而是一行必须出现在 PHP 文件最顶部（紧接 后）的声明：

 


declare(strict_types=1) 必须是文件中第一个可执行语句（注释、空白行可以有，但不能有 echo、$var = ... 等）
它只对当前文件生效，不会影响 include 或 require 的其他文件
值为 0 或不写，就是弱类型模式；只有显式写 1 才开启严格检查
如果放错位置（比如在 echo 后面），PHP 会直接报 Parse error: declare() must be used at the beginning


PhpStorm 怎么帮你写对 strict_types
虽然 PhpStorm 不“开启”它，但它能显著降低写错概率：

新建文件时选 New → PHP File，模板默认不带 declare，但你可以编辑模板：Settings → Editor → File and Code Templates → Files → PHP File，把 declare(strict_types=1); 加到  下一行

输入 declare 后按 Tab，PhpStorm 会自动补全完整语法并高亮错误位置（比如发现前面有输出就标红）
当你调用带类型声明的函数却传了错误类型（如传字符串给 int 参数），PhpStorm 会在编辑器里直接标黄警告，并在悬停时显示 Expected int, got string

配合 PHPStan 或 Psalm 插件，还能在编码阶段提前发现跨文件的 strict_types 不一致问题


为什么写了 strict_types 却没报错？常见失效原因
现象：加了 declare(strict_types=1)，但 add("5", "3") 还是返回 8，没抛 TypeError——大概率是下面某条出了问题：


								


									Dzine

一站式AI图像生成、设计、编辑平台

								下载 
							

立即学习“PHP免费学习笔记（深入）”；

文件没被 PHP 解释器真正执行（比如你在 PhpStorm 里双击打开但没运行；或用浏览器访问时，Web 服务器没加载该文件）

declare 前有 BOM 字符、空格、UTF-8 签名，导致它不是“第一个语句”（用十六进制编辑器或 file -i filename.php 检查编码）
你测试的是另一个没加 declare 的文件，而函数定义和调用分在两个文件里——strict_types 不跨文件生效
PHP 版本低于 7.0（strict_types 是 PHP 7.0+ 特性），运行 php -v 确认版本

最容易被忽略的一点：strict_types 不是项目级开关，也不是 PhpStorm 设置项，它是一行代码、一个文件、一次声明。你得亲手在每个需要强类型的文件顶部写上它，而且得写对位置、写对语法——IDE 可以提醒你，但没法替你决定要不要用。
https://www.php.cn/faq/1999637.html