package.json

若 package.json 中写的是 ^2.0.15，npm/pnpm 在重新安装时才会拉到 2.0.16；已有 package-lock.json 或 pnpm-lock.yaml 时则保持不变，需显式执行 npm update @ai-sdk/zai 或删除锁文件重装。

对于习惯命令行的用户，可以直接检查扩展安装目录下的 package.json 中的 version 字段来确认版本。

建议升级时优先检查 package.json 中两个被更新依赖的解析版本是否一致，避免因锁文件导致的版本分裂。

Vercel 的框架检测基于项目文件特征（如 package.json、manage.py、next.config.js 等）自动推断项目类型并应用对应构建预设。

在 package.json 中，^4.0.153 表示允许安装 4.x 范围内的最新版本，~4.0.153 只允许 4.0.x 的补丁级更新，精确写 4.0.153 则完全锁定。

建议在 package.json 中使用精确版本或锁定文件，并在 CI 中加入工作流的回归测试，避免自动升级引入不可预期的行为变化。

配置题中源码是ESM却告诉Node用CommonJS解析，报错“不能在模块外使用import”，正确做法是改package.json的type字段，而不是删掉测试。

package.json 中的 ^1.0.157 允许自动接受 1.x 内的补丁与次版本，而 lockfile 会锁定实际解析到的确切版本。

对于使用 caret 依赖范围的项目，重新安装依赖即可自动获取 @ai-sdk/vue@2.0.278；若使用精确版本或锁文件，则需要手动更新或运行 npm update。

清单文件（如 package.json、requirements.txt、Cargo.toml）声明项目依赖及版本范围；锁文件（如 package-lock.json、poetry.lock、Cargo.lock）精确记录每个依赖的实际安装版本及完整依赖树。

claude-code-setup 通过读取 package.json 和目录结构等文件来推断项目类型和工具链。

当 provider-utils 升级而 @ai-sdk/voyage 的 package.json 中仍写着较宽松的范围（如 ^4.0.60）且 lockfile 未刷新时，实际安装到的可能是旧版 provider-utils，从而产生版本错配问题。

project.faf 是位于仓库根目录的小型 YAML 文件，与 package.json 并存，保存目标、技术栈、用户、是什么、为什么等可验证事实。

使用 @cline/core 较稳妥的做法是在 package.json 中写死精确版本（如 0.0.93），而非使用 ^0.0.93 这类范围写法

在 package.json 中使用精确版本号而非 ^ 或 ~ 前缀，是跟进高频迭代的稳妥做法

在 JavaScript 生态中，package.json 中的 ^ 前缀会自动允许次版本和补丁版本的升级，但锁定文件会固定具体版本

开发者可借助 package.json 中的 ^ 或 ~ 版本范围符号来平衡自动跟进与稳定性之间的取舍

对于依赖 0.0.x 版本的 package.json，不建议使用 ^ 或 ~ 等宽松版本范围，而应使用精确版本号以避免拉取到不兼容更新

在 package.json 中使用语义化版本范围锁定（例如 ^3.0.0 而非精确版本）可以在保持灵活性的同时降低意外引入破坏性变更的风险

在 package.json 中使用 ^1.0.130 这样的插入符约束，可以允许自动接收后续补丁更新，同时屏蔽可能带来不兼容风险的次版本升级