23 Shell

  1分钟内可阅读完  

原文链接: https://tauri.app/plugin/shell/

访问系统 shell，允许你启动子进程。

支持的平台

平台支持程度说明
Windows完整支持
Linux完整支持
macOS完整支持
Android部分支持
iOS部分支持

设置

自动

使用你的项目包管理器添加依赖：

1

npm run tauri add shell

1

yarn run tauri add shell

1

pnpm tauri add shell

1

deno task tauri add shell

1

bun tauri add shell

1

cargo tauri add shell

手动

  1. 在 src-tauri 文件夹中运行以下命令，把插件加入 Cargo.toml 里的项目依赖：

    1

    cargo add tauri-plugin-shell

  2. 修改 lib.rs 初始化插件：

    1
2
3
4
5
6
7

    #[cfg_attr(mobile, tauri::mobile_entry_point)]
pub fn run() {
    tauri::Builder::default()
        .plugin(tauri_plugin_shell::init())
        .run(tauri::generate_context!())
        .expect("error while running tauri application");
}

  3. 用你偏好的 JavaScript 包管理器安装 JavaScript 端绑定：

1

npm install @tauri-apps/plugin-shell

1

yarn add @tauri-apps/plugin-shell

1

pnpm add @tauri-apps/plugin-shell

1

deno add npm:@tauri-apps/plugin-shell

1

bun add @tauri-apps/plugin-shell

用法

shell 插件在 JavaScript 和 Rust 中都可以使用。

语言

1
2
3
4
5
6
7
8
9

import { Command } from '@tauri-apps/plugin-shell';
// 使用 `"withGlobalTauri": true` 时，你可以这样写
// const { Command } = window.__TAURI__.shell;

let result = await Command.create('exec-sh', [
  '-c',
  "echo 'Hello World!'",
]).execute();
console.log(result);

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

use tauri_plugin_shell::ShellExt;

let shell = app_handle.shell();
let output = tauri::async_runtime::block_on(async move {
		shell
				.command("echo")
				.args(["Hello from Rust!"])
				.output()
				.await
				.unwrap()
});
if output.status.success() {
		println!("Result: {:?}", String::from_utf8(output.stdout));
} else {
		println!("Exit code: {}", output.status.code().unwrap());
}

权限

默认情况下，所有有潜在危险的插件命令和作用域都被阻止，无法访问。你必须在 capabilities 配置中修改权限才能启用它们。

更多信息请参阅能力概述，以及使用插件权限的分步指南。

1
2
3
4
5
6

{
  "permissions": [
    ...,
    "shell:default"
  ]
}
最后修改 September 26, 2026: 更新 (630b11f59)