flutter run与打包后macOS应用调用Process.run/start启动tensorboard表现差异问题

根因说明 #

• 沙盒限制：flutter run启动的应用父进程为终端，默认绕开了App Sandbox限制；打包后的应用独立运行时会触发沙盒的进程创建拦截，最初的崩溃、开启runInShell后执行失败都是沙盒拦截导致的。
• 环境变量不一致：终端运行时会自动加载用户~/.zshrc/~/.bash_profile下的PATH配置，能正常找到tensorboard可执行文件；打包后的应用进程仅加载系统默认环境变量，缺失用户自定义的PATH配置，无法定位tensorboard路径。

修复步骤 #

1. 关闭App沙盒 #

打开项目macos/Runner.xcodeproj，在Xcode中选中Runner target，切换到「Signing & Capabilities」标签，删除App Sandbox项即可。若后续需要上架App Store，再按需配置对应权限即可。

2. 模拟终端环境执行命令 #

两种方式可选，均可实现和终端执行完全一致的效果：

方式1：显式指定tensorboard绝对路径

先在终端执行which tensorboard拿到完整可执行路径，比如常见路径为/opt/homebrew/bin/tensorboard、/usr/local/bin/tensorboard或Python虚拟环境下的自定义路径，调用时直接传入完整路径：

ProcessResult res = await Process.run(
  '/opt/homebrew/bin/tensorboard', // 替换为实际查询到的路径
  ['--logdir=./logs'], // 替换为实际参数
  runInShell: true,
  workingDirectory: '/Users/xxx/project', // 可选，指定和终端执行一致的工作目录
);

方式2：通过登录shell执行命令

直接调用系统shell并传入-l参数，让shell加载完整用户环境变量，无需手动指定路径：

ProcessResult res = await Process.run(
  '/bin/zsh', // 若用户默认shell为bash则替换为/bin/bash
  ['-l', '-c', 'tensorboard --logdir=./logs'],
  workingDirectory: '/Users/xxx/project', // 可选，指定工作目录
);

其中-l参数表示以登录模式启动shell，会加载全部用户环境配置，执行效果和终端完全一致。

3. 可选权限配置 #

如果执行时涉及文件读写失败，可在Xcode的「Signing & Capabilities」中添加对应目录的读写权限，比如下载目录、文档目录的读写权限。

内容的提问来源于stack exchange，提问作者EchoShao