Struct CommandSpec 

pub struct CommandSpec {
    pub program: OsString,
    pub args: Vec<OsString>,
    pub cwd: Option<PathBuf>,
}

一条待执行的命令。

纯数据：插件只描述“跑什么“，不负责跑。真正的 spawn 由宿主做 —— 这样 stdio、 环境、退出码的处理只有一处实现，插件不会各写各的。

构造是链式的，而且是消费式的

let spec = CommandSpec::new("cargo")
    .arg("add")
    .args(args.iter())
    .cwd("/somewhere");

消费式（self → Self）而不是 &mut self，是为了让上面这种写法直接产出一个值， 不用先 let mut 再逐行调。

Fields

program: OsString

可执行文件。宿主会用 which 解析成真实路径，并按平台决定要不要包一层 cmd /C（Windows 上 pnpm 是 pnpm.cmd，直接 spawn 会失败）。

args: Vec<OsString>

参数，按顺序。

cwd: Option<PathBuf>

工作目录覆盖。None = 用宿主给的项目根。

Implementations

impl CommandSpec

pub fn new(program: impl Into<OsString>) -> Self

指定可执行文件。

pub fn arg(self, arg: impl Into<OsString>) -> Self

追加一个参数。

pub fn args<I, S>(self, args: I) -> Self

where I: IntoIterator<Item = S>, S: Into<OsString>,

追加一批参数。

args.iter()（&[OsString]）可以直接传进来 —— &OsString: Into<OsString>， 所以这是无损的，不会像 String 那样在 Unix 上把非 UTF-8 参数改坏。

pub fn cwd(self, dir: impl Into<PathBuf>) -> Self

覆盖工作目录。

Trait Implementations

impl Clone for CommandSpec

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CommandSpec

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for CommandSpec

impl PartialEq for CommandSpec

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for CommandSpec