pinset use

什么时候用

首次选版本、升级或切回旧版本时使用。use 决定版本，install 按已经确定的锁还原版本。

示例

pinset use node@24 pnpm@10
pinset use python@3.14 --plan

执行结果：第一条解析确切版本，更新 .pinset/config.toml 和 .pinset/lock.toml，安装并准备命令入口；第二条只预览。

行为细节

通常联网查询版本和产物，安装时下载或复用已校验缓存。配置和锁通过事务更新；安装、本地绑定写入 Pinset home 和项目本地状态，Python 还可能准备 .venv。--no-install 仅提交选择和锁。预览可能联网，不写状态。

pnpm 必须具备 Node 选择。修改配置 selector 或 Rust 选项后，明确执行 use tool@selector 重新生成锁；安装和执行不自行补锁。同一调用不能重复工具。额外 CLI 见自定义工具指南。

注意事项：支持 pnpm 10 CJS、11 ESM、12 原生发布包；原生包与共享文件都会落锁并校验。项目声明与锁定 pnpm 或运行时不匹配时明确报错，不自动切换工具链。

参数、退出码与常见错误

成功返回 0，操作失败返回 1。PINSET_SELECTOR_REQUIRED 表示缺少选择器；PINSET_SELECTION_DUPLICATE 表示重复工具；PINSET_PLATFORM_UNAVAILABLE 表示平台无产物。调整选择后重试，不要手改锁绕过校验。