手写 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
src/ 下有没有 PHP 文件——它只按规则生成映射。等你第一次 new AppHttpController() 时才发现类不存在，而错误堆栈里根本不会提 composer.json 的事。
