手写 composer.json 必须符合 JSON 语法、编码规范及 Composer 语义约束：禁用 BOM、仅用英文双引号、对象末项无逗号、缩进用空格不用 Tab；最小必需字段为 name、autoload、require；autoload 失效主因是路径与命名空间错位且需手动 dump-autoload。

composer.json 不是“创建出来就能用”的配置文件，它必须符合 JSON 语法、编码规范和 Composer 的语义约束。直接手写比盲目依赖 composer init 更可控，尤其当你清楚项目性质时。

手写 composer.json 要避开哪些隐藏字符和格式雷区

常见报错 JSON decode error: Syntax error 几乎都源于编辑器悄悄塞进来的非法字符：

• 文件开头不能有 BOM（哪怕只多一个不可见字节），VS Code 默认保存为 UTF-8 无 BOM，但 Sublime 或记事本可能默认带 BOM
• 所有键名和字符串值必须用英文双引号 "，不能是中文引号、直角引号或单引号
• 对象最后一项后面禁止逗号（"php": "^8.2", → 错误；"php": "^8.2" → 正确）
• 缩进只能用空格，不能用 Tab —— Composer 不认 Tab，但不会明确报错，而是静默失败
• 写完立刻去 jsonlint.com 粘贴校验，别等 composer install 报错才查

composer init 适合什么场景？不适合什么场景？

composer init 是交互式生成器，不是项目初始化命令。它只输出一个 composer.json 文件，不建目录、不拉代码、不装依赖。

Pandas 配置文件报告生成器

使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。

下载

• 适合已有代码结构，想补个基础配置（比如老项目迁移到 Composer 管理）
• 不适合开新项目：执行完你还是面对一个空目录，vendor/ 没有，index.php 没有，连 src/ 都得自己建
• 它默认不填 autoload，也不设 config.platform.php，这两项漏掉会导致后续类找不到、PHP 版本兼容性出问题
• 如果只是想快速跑起 Laravel，直接用 composer create-project laravel/laravel myapp，别碰 init

最小可用 composer.json 必须包含哪几项？

空的 require 可以接受，但以下字段缺一不可，否则 composer dump-autoload 会失效或类加载失败：

• "name"：私有项目可省略，但建议填（如 "myorg/myapp"），避免未来发布到 Packagist 时重填出错
• "autoload"：哪怕只配最简 PSR-4："psr-4": {"": "src/"}，确保类文件在 src/ 下能被自动加载
• "require"：至少写 {"php": "^8.2"}，显式声明运行环境，防止依赖装到不兼容版本
• "type"：非必须，但若项目是 Laravel 应用、WordPress 插件或 CLI 工具，填对类型（如 "project"、"wordpress-plugin"）才能触发对应安装逻辑

为什么 autoload 配置总不生效？

路径和命名空间错位是最隐蔽的问题，Composer 不报错，只默默跳过加载：

• "autoload": {"psr-4": {"App\": "src/"}} 要求类文件路径为 src/Http/Controller.php，且命名空间必须是 AppHttpController
• 路径必须相对于 composer.json 所在目录（即项目根目录），写成 "./src/" 或绝对路径会失败
• 如果用了 "classmap"，指定的目录必须真实存在且 PHP 进程有读取权限，否则 composer install 会静默忽略
• 改完 autoload 后必须运行 composer dump-autoload，否则不会更新 vendor/autoload.php

真正容易被忽略的是：Composer 不验证你写的命名空间是否和实际文件匹配，也不检查 src/ 下有没有 PHP 文件——它只按规则生成映射。等你第一次 new AppHttpController() 时才发现类不存在，而错误堆栈里根本不会提 composer.json 的事。