核心问题是未声明就用或未按框架规则注册；ThinkPHP需继承think\console\Command、setName并显式addOption，pytest需在conftest.py中addoption，PHP CLI须用$argv而非未定义$args。
自定义命令参数解析报错，核心问题通常不在“写错了”，而在于“没声明就用”或“没按框架规则注册”。不同工具链对参数的识别逻辑差异很大，但共性错误高度集中——下面分场景说清楚怎么快速定位和修复。
ThinkPHP 命令类参数不生效或取不到值
常见表现：执行 php think send:email --to=admin@example.com，但在 execute() 里 $input->getOption('to') 返回 null，且无任何报错。
- 必须继承
think\console\Command，不能是普通类或旧版think\command\Command -
configure()中必须调用$this->setName('send:email')，否则命令注册静默失败 - 所有选项（如
--to）必须显式用$this->addOption('to', null, Option::VALUE_REQUIRED, '收件人')声明 - 位置参数（如
php think make:controller User中的User）要用addArgument()，不能混进addOption() - 别写
handle()方法——TP6 只调用execute(Input $input, Output $output)
pytest 自定义参数始终为空
典型现象：在 conftest.py 里加了 addoption，命令行传了 --env=staging，但测试中 request.config.getoption('--env') 报错或返回默认值。
-
pytest_addoption(parser)必须定义在项目根目录或测试目录下的conftest.py，不能放在普通.py文件里 - 添加选项时，名称不要带前缀
--：parser.addoption("--env", ...)是对的，但取值时用config.getoption("env")或config.getoption("--env")都可（推荐前者） - 确保命令行调用路径正确：在含
conftest.py的目录下运行pytest --env=prod，而不是从子目录或 IDE 终端误启 - 检查 pytest 版本是否 ≥ 6.0；老版本对长选项支持不稳定
PHP CLI 脚本报 Undefined array key
比如直接写 $filter = $args[1];，运行 php list.php 就警告，但加了参数又正常——这不是 bug，是访问未校验索引。
- PHP CLI 下只认
$argv，$args是你自己定义的变量，不写赋值就不存在 - 安全写法：先判断长度，再取值。例如：
$filter = $argv[1] ?? 'all';或if (isset($argv[1])) { $filter = $argv[1]; } -
$argv[0]是脚本路径，用户第一个参数永远是$argv[1]，别从$argv[0]开始数 - 复杂参数建议用
getopt()或第三方库（如 symfony/console），避免手撕逻辑
通用调试思路：三步锁定根源
不管用什么工具，遇到参数解析失败，按顺序查这三项：
- 看命令是否被识别：运行
php think list或pytest --help，确认你的命令/选项是否出现在帮助列表里 - 看参数是否被声明：翻代码，确认
addOption、addargument、addoption等注册语句确实存在且拼写一致 - 看调用是否匹配：对比帮助输出里的格式，检查空格、等号、引号——例如
--port=8080和--port 8080在某些框架中不等价
