工具管理
pinset exec
在项目选定的工具链和环境变量下运行命令,保留程序原始输出和退出状态。
在 GitHub 查看源文档 ↗什么时候用
希望脚本、CI 或当前终端明确使用项目工具链时使用,无需依赖 shell 接入是否生效。Maven、Gradle 优先用项目 wrapper。
示例
pinset exec -- node --version
pinset exec -- ./mvnw verify
pinset exec -- ./gradlew build
第一条输出项目 Node 版本,如 v24.0.0;后两条输出和退出状态来自构建本身。
行为细节
不自动安装或改版本。准备锁定工具环境后运行原始命令。选中加密 profile 时要求信任和解密权限,原有进程变量冲突会报错。子进程可以联网、写文件和调用外部 toolchain,执行入口不是沙箱。
参数、退出码与常见错误
| 参数 | 含义 |
|---|---|
--profile <profile> | 本次指定环境档案。 |
--no-env | 禁用加密环境,与 --profile 互斥。 |
-- <command...> | 原始命令和参数。 |
启动后转发程序退出状态;准备失败为 1,参数错误为 2。不接受 --json(PINSET_NATIVE_OUTPUT)。PINSET_ENV_COLLISION 表示变量已存在,检查进程环境后重试。
/docs/commands/exec适用版本 · Pinset 3.1.0