工具管理

`pinset install`

按项目锁文件安装工具，让新电脑或 CI 还原已经确定的工具链。

什么时候用

克隆项目后、补装缺失工具或恢复损坏安装时使用。升级或切换版本用 use。

示例

pinset install
pinset install node pnpm --offline

执行结果：第一条安装锁中工具并建立绑定；第二条只用本地缓存还原 Node、pnpm 及其锁定依赖，缓存缺失就失败。

行为细节

配置和锁必须有效且匹配。只使用锁中版本、地址、摘要；缓存和下载均校验，不重新解析版本。写入安装、命令入口、本地绑定，并按锁准备受管 Python 环境或 Flutter 链接，不更改工具选择。指定工具时只处理这些工具及其运行时依赖，不处理无关环境或链接。

--repair 不接管外部安装。--recreate-venv 只重建有效受管环境，且本次选择须包含 Python。use 和 install 在交互 stderr 展示阶段、下载进度和缓存复用；大小已知时显示百分比、速度和剩余时间。JSON 或重定向 stderr 时隐藏进度界面。

参数、退出码与常见错误

参数	含义
`[tool...]`	只安装指定工具及依赖；省略则安装项目工具。
`--global`	按全局锁安装。
`--offline`	不下载，只用有效安装或已校验缓存。
`--repair`	修复受管工具安装。
`--recreate-venv`	明确重建受管 Python 环境。
`--plan`	只列安装计划，不下载或写入。

成功返回 0，失败返回 1。PINSET_LOCK_MISSING 需先由维护者生成锁；PINSET_LOCK_MISMATCH 需用 use 对齐选择；PINSET_TOOL_NOT_SELECTED 表示工具未被选择。外部 .venv 会保留，先检查所有权。

/docs/commands/install适用版本 · Pinset 3.1.0