唯一正确安装方式是composer require symfony/console，它自动适配PHP版本，但需手动创建bin/console入口文件并显式注册命令类，不支持自动发现或补全（后者需额外安装扩展包）。
composer require symfony/console 是唯一安装路径
别找“Console_Composer”或“symfony-console-composer”这类不存在的包名，所有稳定项目都只走 composer require symfony/console 这一条路。它不是框架插件，而是独立组件——装完就是一堆 PHP 类，不会自动建文件、不会注册命令、也不会生成 bin/console。
版本适配由 Composer 自动处理：PHP ≥ 8.1 装 v6/v7；PHP 7.2–8.0 则 fallback 到 ^5.4。若报错类似 Root composer.json requires symfony/console ^6.0, found ... but these were not loaded，大概率是 composer.json 里写了过高的 "config": {"platform": {"php": "8.2.0"}}，而你本地实际是 PHP 8.0 —— 删掉或改对再 composer update。
仅用于本地脚本（比如日志清理、CSV 导入）？加 --dev：composer require symfony/console --dev，避免上线环境多带无用依赖。
必须手动创建 bin/console 入口文件
php bin/console list 报 Could not open input file？说明根本没建这个文件。Composer 不会替你创建入口，这是硬性前提。
最小可用 bin/console 内容如下（Linux/macOS 记得 chmod +x bin/console）：
#!/usr/bin/env php <?php require __DIR__.'/../vendor/autoload.php'; use Symfony\Component\Console\Application; $application = new Application(); $application->run();
常见错误：
-
require路径写错，比如少一个..，导致 autoload 找不到 - 没加 shebang 行（
#!/usr/bin/env php），在某些 shell 下无法直接执行./bin/console - 入口文件没放在
bin/目录下，或名字不是console，后续调用时路径全错
命令类必须显式注册，不支持自动发现
哪怕你把命令类放在 src/Command/ 下，哪怕类名规范、继承了 Symfony\Component\Console\Command\Command，只要没在入口里 $application->add(new App\Command\YourCommand())，它就永远不会出现在 list 输出里。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
注册时三个条件缺一不可：
- 类必须继承
Command，不能是普通 class -
configure()中必须调用$this->setName('app:do-something')—— 名字为空，Application就跳过它 - 入口文件中必须显式
add()实例，不能依赖“扫描目录”这种不存在的机制
示例注册片段：
use App\Command\ClearLogCommand; // ... $application->add(new ClearLogCommand());
自定义补全需额外引入 completion 包
Symfony Console 本身不带自动补全功能。要让 ./bin/console app:clear-log [TAB] 补全参数或选项，得额外装 stecman/symfony-console-completion 或 bamarni/symfony-console-autocomplete。
前者适合嵌入到你的应用中（通过 CompletionCommand 注册为内置命令），后者是全局 shell 补全方案。两者都不在 symfony/console 默认能力范围内。
注意点：
- 补全脚本依赖 shell 环境（Bash/Zsh），Docker 容器里可能需要显式设
SHELL=bash - 如果用了命令别名（如
alias c='php bin/console'），补全工具默认不认识，得手动传--aliases=c - 补全逻辑需配合
addArgument()和addOption()的闭包回调，否则只能补全命令名，补不了参数值
补全不是“装完就生效”，它是个独立层，容易被当成 Console 自带能力而漏掉配置。
