pinset
EN
工具管理

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