PHPStan提示‘可迭代类型未指定值类型’但已声明的解决咨询

方案1：修正PHPDoc注释格式 #

确保属性注释采用标准文档注释（以/**开头），让PHPStan能正确关联PHPDoc与实际类型声明。修改后代码如下：

<?php

class Foo
{
    /**
     * @var array<string>
     */
    private array $foo;
}

此时PHPStan会读取PHPDoc中的array<string>作为数组成员类型，同时认可PHP 7合法的array类型声明，不再抛出警告。

方案2：配置PHPStan目标PHP版本 #

若方案1无效，在PHPStan配置文件（通常为phpstan.neon或phpstan.neon.dist）中明确设置项目的PHP版本为7.x，让PHPStan适配PHP 7的语法限制：

parameters:
    phpVersion: 70400 # 对应PHP 7.4，可根据实际版本调整，如70300对应PHP 7.3

配置后，PHPStan会理解PHP 7不支持泛型数组语法，优先以PHPDoc的类型信息校验数组成员。

方案3：使用PHPStan专属注解 #

如果需要明确区分PHP语法与PHPStan校验规则，可使用@phpstan-var注解单独为PHPStan提供类型信息，同时保留PHP合法的类型声明：

<?php

class Foo
{
    /**
     * @phpstan-var array<string>
     */
    private array $foo;
}

这种写法不影响PHP语法解析，同时能让PHPStan准确识别数组成员类型。

内容的提问来源于stack exchange，提问作者Aayla Secura