如何配置 ECC 的包管理器检测CLAUDE_PACKAGE_MANAGER 与 /setup-pm【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC在 ECC 项目中插件和脚本需要知道该用 npm、pnpm、yarn 还是 bun 来执行install、run、test等命令。ECC 内置了一套包管理器检测机制按固定优先级从环境变量、项目配置、package.json、lock 文件、全局配置中确定使用哪一个并提供了/setup-pm命令和scripts/setup-package-manager.js脚本用于查看和设置检测结果。本文说明这套检测的优先级规则、四种配置方式以及检测结果出错时如何修正。ECC 的核心 Node.js CLI 在 Windows、macOS 和 Linux 上均可运行见 README.md 的 Cross-Platform Support 一节因此以下命令在三大平台都适用环境变量写法区分 PowerShell 与 bash。检测按什么顺序确定包管理器ECC 支持npm、pnpm、yarn、bun四个包管理器见 scripts/lib/package-manager.js。检测按以下优先级从高到低执行命中即停止环境变量CLAUDE_PACKAGE_MANAGER项目配置.claude/package-manager.jsonpackage.json的packageManager字段Lock 文件package-lock.json、yarn.lock、pnpm-lock.yaml、bun.lockb全局配置~/.claude/package-manager.json兜底无匹配时的默认行为两点需要注意环境变量只有取值为npm、pnpm、yarn、bun之一时才会被采用代码中通过PACKAGE_MANAGERS[envPm]校验其他值会被忽略并继续走后续优先级。关于第 6 级兜底文档之间存在差异commands/setup-pm.md 和 README.md 描述为“First available package manager”fallback 顺序pnpm bun yarn npm而当前实现 scripts/lib/package-manager.js 中第 6 步直接固定返回npm注释说明旧版本会逐个 spawn 子进程检查可用性在 Windows 上导致插件卡死因此改为固定 npm 作为安全默认值。以实际源码行为为准时是默认npm本文保留两处表述读者可按自己使用的版本对照。packageManager字段的值可以带版本如pnpm8.6.0代码按截取前半部分识别管理器名也接受纯名字如pnpm。如何查看当前检测结果在 ECC 仓库根目录下运行来自 commands/setup-pm.md# 检测当前包管理器 node scripts/setup-package-manager.js --detect # 列出可用包管理器 node scripts/setup-package-manager.js --list--detect的输出包含三部分字段来自 scripts/setup-package-manager.js 的detectAndShow()Current selectionPackage Manager与Source两个字段。Source的取值environment、project-config、package.json、lock-file、global-config、default直接告诉你检测结果来自哪一级优先级这是判断配置是否生效的关键字段。Detection resultsFrom package.json、From lock file、Environment var三行的独立探测值用于区分“某一级有值但被更高优先级覆盖”的情况。Available package managers以✓/✗标记四个包管理器是否已安装在系统上当前选中的会标注(current)。--list会额外显示每个管理器的 lock 文件名与install/run命令映射。--detect和--list都是只读操作不修改任何配置注意它们会通过where.exe/which检查系统上已安装的包管理器源码注释提示这类检查不要在会话启动的热路径上高频调用。如何配置环境变量、全局、项目、package.json按“作用范围”从小到大文档支持四种配置方式commands/setup-pm.md、README.md1. 环境变量优先级最高覆盖一切# Windows (PowerShell) $env:CLAUDE_PACKAGE_MANAGER pnpm # macOS/Linux export CLAUDE_PACKAGE_MANAGERpnpm注意export只影响当前 shell 会话若需持久生效TROUBLESHOOTING.md 的建议是将其写入~/.bashrc或~/.zshrc。2. 全局偏好写入~/.claude/package-manager.json副作用创建或覆盖该用户级配置文件# 设置全局偏好为 pnpm node scripts/setup-package-manager.js --global pnpm成功后脚本输出Global preference set to: pnpm与保存路径。若 pnpm 未安装脚本会打印Warning: pnpm is not installed on your system但仍会保存配置——设置前建议先确认该管理器已安装。3. 项目偏好写入项目根目录下的.claude/package-manager.json副作用创建或覆盖该文件可随仓库提交# 为当前项目设置 bun node scripts/setup-package-manager.js --project bun直接裸写管理器名等价于--globalnode scripts/setup-package-manager.js pnpm--global/--project的配置文件内容为{ packageManager: bun }4. package.json 的 packageManager 字段{ packageManager: pnpm8.6.0 }TROUBLESHOOTING.md 给出了用 npm 设置该字段的命令npm pkg set packageManagerpnpm8.15.05. Lock 文件隐式检测项目根目录存在package-lock.json、pnpm-lock.yaml、yarn.lock或bun.lockb时按pnpm bun yarn npm的顺序识别对应管理器。这是团队内约定俗成的方式不需要任何配置。如何验证配置已生效配置后重新运行node scripts/setup-package-manager.js --detect检查两个字段Package Manager是否为你期望的值Source是否指向你配置的级别例如设置环境变量后应为environment--project后应为project-config。若Source不是预期级别对照Detection results段各行的取值即可定位是哪一层配置在更高优先级上压过了你的设置例如本意用--project bun但环境变量CLAUDE_PACKAGE_MANAGER仍被导出此时Source会显示environment。TROUBLESHOOTING.md 的 “Getting Help” 一节也把echo $CLAUDE_PACKAGE_MANAGER列为诊断信息之一用于排查环境变量残留。检测出错的已知问题与处理TROUBLESHOOTING.md 的 “Package Manager Detection Fails” 小节描述的现象是使用了错误的包管理器例如项目里想用 pnpm 却跑了 npm。文档列出的原因项目里没有 lock 文件CLAUDE_PACKAGE_MANAGER未设置多个 lock 文件并存导致检测混淆检测按pnpm bun yarn npm顺序取第一个命中的 lock 文件多个 lock 文件同时存在时结果偏向排序靠前的一侧。文档给出的解决命令即前文的export CLAUDE_PACKAGE_MANAGERpnpm、echo {packageManager: pnpm} .claude/package-manager.json、npm pkg set packageManagerpnpm8.15.0。文档还提到可以删除多余 lock 文件来消除混淆但同一小节明确警告删除 lock 文件会改变已安装依赖的版本只有在有意切换包管理器时才能执行且操作前必须先提交或备份 lock 文件、删除后重新安装并重跑 CI。这是有破坏性的操作不属于常规配置手段仅在切换包管理器这一特定场景下使用。限制只有npm、pnpm、yarn、bun四个取值有效无论出现在环境变量、项目配置还是全局配置中未知名称不会被采用脚本会报Unknown package manager或Unknown option错误。环境变量优先级最高设置它之后其他所有配置都只在其被取消后才生效用--detect的Source字段可以随时确认当前生效来源。兜底行为在文档与当前源码间存在前述差异“first available” vs 固定npm排查“为什么最终用了 X”时应以--detect实际输出的Source为准。相关文档commands/setup-pm.md、scripts/setup-package-manager.js、scripts/lib/package-manager.js、TROUBLESHOOTING.md。【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考