“Undefined variable”是E_NOTICE级运行时警告，不中断执行但暴露变量未声明、拼写错误、分支未执行致未定义、字符串拼接前未初始化、依赖扩展/环境变量缺失、作用域遗漏等隐患。
PHP 报“Undefined variable”不是语法错误，而是运行时的 E_NOTICE 级别警告——它不中断执行（除非你主动提升错误级别），但暴露了代码中真实存在的隐患：变量可能根本没被创建、拼错名、漏初始化，或依赖的环境条件不满足。
变量未声明就直接读取会触发 Notice
PHP 不像 JavaScript 那样有变量提升（hoisting），$foo 出现在 echo $foo; 前必须已赋值。哪怕只写 $foo;（无等号）也无效，这行是空语句，不创建变量。
- 错误示例：
$name = "Alice"; echo $nmae;→ 拼写错误，$nmae从未存在 - 错误示例：
if (false) { $result = true; } echo $result;→ 分支未执行，$result未定义 - 正确做法：显式初始化，如
$result = false;或直接返回表达式，避免中间变量
字符串拼接 .= 要求变量已存在且为字符串
$body .= "Text"; 等价于 $body = $body . "Text";，PHP 必须先读取 $body 的当前值。若 $body 根本没声明，就会报 Undefined variable。
- 常见于邮件组装、日志拼接等场景
- 不能靠
$_POST['body'] ?? ''代替初始化——如果字段名其实是message，强行读body会额外触发Undefined index - 安全写法：
$body = '';放在所有.=操作之前；或用空合并操作符逐字段处理：$body .= "Name: " . ($name ?? '') . "\n";
依赖扩展或环境特性的变量容易“消失”
探针类脚本常出问题：直接写 echo $gd_info['version'];，但 GD 扩展没启用，$gd_info 就不存在。
立即学习“PHP免费学习笔记（深入）”；
- 不是变量名写错了，而是整个变量压根没被生成
- 必须前置检查：
if (extension_loaded('gd')) { $gd_info = gd_info(); }，否则设默认值如$gd_info = null; - 同理对待
$_SERVER键（如SERVER_SOFTWARE在 Nginx 下不存在）、apache_get_modules()（仅 Apache 模块模式有效）等
作用域遗漏：函数里用不到全局变量
函数内部无法自动访问同名全局变量。写 $config = 'dev'; function init() { echo $config; } 会报错——$config 在函数作用域内未定义。
- 不推荐用
global $config;（破坏封装，难测试） - 更稳妥的是作为参数传入：
function init($config) { ... } - 闭包需显式
use ($config)导入
最易被忽略的一点：错误本身不致命，但掩盖逻辑缺陷。比如 $primarykey 在 CSV 解析循环中只在某行被赋值，而 echo $primarykey; 写在循环外——若 CSV 第一行是表头、实际数据为空，$primarykey 就永远没机会初始化，后续 SQL 会出错或生成无效语句。
