PHP7.4.3/CodeIgniter3.1.13中@param/@return类型大写的原因及必要性？

结论：没有硬性强制，但大写类型是符合主流实践的选择，结合你的场景（PHP7.4、CI3、VSCode），具体分析如下：

为什么VSCode会高亮大写类型？ #

你看到的绿色高亮，是VSCode的PHP插件（比如Intelephense）对PHPDoc中大写类型标识的语法高亮逻辑——插件会把大写的类型识别为“类型声明”，从而赋予特殊高亮，本质是插件的解析规则，不是语法错误。

是否应该大写？分两种情况： #

• 自定义类/接口/Trait：必须大写。因为PHP类名的命名惯例就是首字母大写，IDE也能通过大写类名正确识别并跳转至类定义，避免混淆；
• PHP内置标量类型（int/string/bool/float等）：大小写都合法，但建议统一项目风格——要么全大写，要么全小写，一致性比单种写法更重要。

选择大写的原因 #

1. IDE体验更好：像你遇到的高亮效果，能让类型信息在注释里更醒目，快速区分类型和普通描述文本；
2. 规范对齐：不少团队和PHPDoc实践规范会要求大写类型，尤其是在多人协作项目中，统一风格能提升代码可读性；
3. 避免歧义：在复杂的函数注释里，大写类型比小写更突出，减少阅读时的视觉混淆。

举两个合法的示例，选一种保持统一就行：

// 大写类型风格
/**
 * 获取用户详情
 * @param Int $userId 用户ID
 * @return Array|null 用户信息数组或空值
 */
function getUserDetail($userId) {
    // 业务逻辑
}

// 小写原生风格
/**
 * 获取用户详情
 * @param int $userId 用户ID
 * @return array|null 用户信息数组或空值
 */
function getUserDetail($userId) {
    // 业务逻辑
}

另外，CodeIgniter 3本身没有强制的PHPDoc规范，所以完全可以根据自己或团队的习惯来选，核心是保持项目内的注释风格一致。

内容的提问来源于stack exchange，提问作者Mr. J