composer install 不是初始化命令，仅在含 composer.lock 的项目中按锁文件精确还原依赖；空目录运行会报“no composer.json”，有 json 无 lock 则报兼容性错误，php 或扩展缺失时错误常被掩盖为网络问题。
composer install 不是“默认命令”，它只在已有 composer.json 和 composer.lock 的项目里才安全执行；全新环境第一步从来不是 composer install，而是确认 PHP 可用、装好 Composer 二进制、再决定用 composer create-project 还是 composer init。
为什么直接运行 composer install 大概率报错
它不创建项目结构，也不生成 composer.json —— 它只读取当前目录下的 composer.lock，然后按锁定文件逐个下载依赖到 vendor/。如果你刚新建一个空文件夹就跑 composer install：
- 会提示
No composer.json present in the current directory或Could not open input file: composer.phar（路径/权限问题） - 即使有
composer.json但没composer.lock，它也不会自动生成 lock 文件，而是报Your lock file does not contain a compatible set of packages - 如果 PHP 版本或扩展缺失（如
curl、openssl、json），错误信息常被掩盖成 “Connection refused” 或 “SSL certificate problem”，实际是底层不可用
composer create-project 才是新手第一命令
它才是能从零拉起一个可运行项目的命令，自动完成：下载模板包、解压、写 composer.json、生成 composer.lock、安装全部依赖、执行初始化脚本（比如 Laravel 的 artisan key:generate）。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 基础用法：
composer create-project laravel/laravel myapp（会建myapp/目录并初始化） - 指定稳定小版本：
composer create-project laravel/laravel myapp "10.42.*"（引号防 shell 解析） - 跳过交互（CI 场景）：
composer create-project --no-interaction laravel/laravel myapp - 国内用户务必提前配镜像，否则卡在
Downloading laravel/laravel阶段超时：运行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
PATH 配不进去，composer 命令就永远找不到
装完后输 composer --version 报 “command not found”，不是 Composer 没装好，是系统根本没找到那个文件。
- macOS/Linux：确认
composer.phar已移至/usr/local/bin/composer，且加了执行权限：sudo chmod +x /usr/local/bin/composer - Windows：别信安装器“Add to PATH”勾选框，手动进「系统属性 → 高级 → 环境变量」，把 Composer 安装目录（如
C:\ProgramData\ComposerSetup\bin）加到系统 PATH - 改完 PATH 后，必须新开终端窗口验证 —— 旧窗口不会重载环境变量
- 杀毒软件（尤其 360、腾讯电脑管家）可能拦截 Composer 的批处理调用，临时禁用再试
composer diagnose 是你该先跑的检查命令
它不装包、不改文件，只告诉你当前环境到底哪里不满足 Composer 运行前提：
- 输出中出现
PHP version: 8.2.12且OK表示版本达标 - 看到
curl extension: OK和openssl extension: OK才说明网络和证书校验能走通 - 若提示
allow_url_fopen: FAILED，需在php.ini中设为On；若提示proc_open is disabled，得在disable_functions里删掉它 - 如果显示
platform settings are ignored，说明项目composer.json里写了"config": {"platform": {"php": "8.3"}}，但你本地是 PHP 8.1 —— 这会导致后续install直接失败
真正容易被忽略的是：Composer 不报错 ≠ 能用。比如 composer install 成功了，但 vendor/autoload.php require 失败，大概率是 vendor/ 目录权限不对（Windows 下常见，Linux/macOS 下常见 777 导致 autoload 加载失败），修复要分清文件（644）和目录（755），而不是一通 chmod 777。
