composer install 会读 composer.json，但仅用于存在性检查和元数据加载；真正决定安装版本的是 composer.lock。若 composer.json 缺失则直接报错退出，若仅 lock 缺失则根据 composer.json 重新生成；两者共存时完全以 lock 为准，忽略 composer.json 中的版本约束。

composer install 读不读 composer.json？

读，但只是“扫一眼”，不是按它装。真正决定装什么版本的，是 composer.lock —— 只要它存在。

常见错误现象：Could not find a composer.json file 或安装了意外版本的包，往往不是 composer.json 写错了，而是你根本没在它所在的目录执行命令，或者 composer.lock 被删了但没意识到后果。

• composer install 启动时会先检查当前目录下是否存在 composer.json；不存在就直接报错退出，连 composer.lock 都不看
• 如果 composer.json 存在但 composer.lock 不存在，Composer 会解析 composer.json 中的 require 和 require-dev，算出兼容版本，下载并生成新的 composer.lock
• 如果两者都存在，composer.json 里写的版本约束（比如 "monolog/monolog": "^2.0"）会被完全忽略；安装行为 100% 由 composer.lock 中记录的精确版本（如 "2.12.0"）、哈希、源 URL 决定
• 注意：即使 composer.json 里删掉某个包，只要 composer.lock 还留着它，composer install 仍会把它装进 vendor/ —— 这不是 bug，是设计使然

为什么不能跳过 composer.json 直接靠 lock 文件运行？

因为 composer.json 是项目元数据的唯一权威来源，而 composer.lock 只是它的“快照”。没有 composer.json，Composer 就无法确认项目类型、自动加载规则（autoload）、脚本定义（scripts）、平台要求（platform）等关键信息。

典型使用场景：CI/CD 构建、Docker 构建镜像、新同事拉代码后首次部署 —— 这些流程依赖 composer install 的确定性，但前提是 composer.json 必须随代码一起提交，且不能被忽略或误删。

Feishu calendar sync, local ics to json data for AI agent

将ICS日历文件转为JSON格式，用于飞书日历导入导出及数据集成。

下载

• autoload 配置只从 composer.json 读取，用于生成 vendor/autoload.php；composer.lock 里不存这部分
• config 段（如 "fxp-asset": {"enabled": false}）也只生效于 composer.json，影响后续所有命令行为
• 如果 composer.json 缺失，即使 composer.lock 完整，composer install 也会失败，并提示 No composer.json found in current directory

composer.json 被修改后，install 会感知吗？

不会。除非你手动删掉 composer.lock 或运行 composer update，否则 composer install 对 composer.json 的任何改动（增删依赖、改版本号、加 autoload 规则）都视而不见。

这恰恰是它稳定性的来源，也是协作中容易被忽略的盲区：有人改了 composer.json 却没提交新的 composer.lock，别人 composer install 时实际装的还是旧版本。

• 新增一个包到 composer.json 的 require？composer install 不会装它 —— 得用 composer require vendor/package 或 composer update vendor/package
• 把 "php": "^8.1" 改成 "^8.2"？composer install 不检查 PHP 版本是否匹配，只按 composer.lock 里记录的包列表往下装
• 改了 autoload？composer install 不会重新生成自动加载文件 —— 得手动运行 composer dump-autoload

容易踩的坑：路径、权限、Git 忽略

最常导致“读不到 composer.json”的，从来不是文件内容问题，而是执行位置或环境配置。

• 在子目录（如 src/ 或 tests/）里执行 composer install → 报错 Could not find a composer.json file in /path/to/src
• composer.json 权限为 600 且不属于当前用户 → 读取失败，错误可能不明确，表现为“空 lock 文件”或静默失败
• Git 仓库中 composer.json 被 .gitignore 误排除，或克隆时用了 --depth=1 且该文件在浅层之外 → 本地根本没这个文件
• Docker 构建时 COPY 顺序写错，比如先 RUN composer install 再 COPY composer.json . → 构建阶段找不到文件

复杂点在于：这些路径和权限问题，和 composer.json 本身的语法是否正确毫无关系。它不报语法错误，只报“找不到文件”——而你第一反应往往是去查 JSON 格式，而不是 pwd 和 ls -l。