MacOS打包后Avalonia应用调用zsh报错：命令未找到

核心原因 #

打包后的Mac App运行在沙箱环境中，和调试时的用户Shell环境存在两个关键差异：

• 环境变量PATH被大幅限制，仅保留系统默认的核心路径（如/usr/bin），而调试时继承了用户Shell的完整PATH；
• 沙箱默认约束子进程执行外部命令的权限，尤其是非系统默认路径下的程序。

你遇到的zsh:1: command not found: 报错，本质是zsh能被正常调用，但要执行的Python（或脚本路径）不在App沙箱的PATH范围内，导致找不到目标命令。

具体解决步骤 #

1. 硬编码Python的绝对路径 #

不要依赖PATH自动查找Python，先在终端执行which python3（或which python）获取绝对路径（通常是/usr/bin/python3或/usr/local/bin/python3），然后在代码中直接写死：

// 替换成你实际查到的Python绝对路径
string pythonPath = "/usr/bin/python3";
// 脚本路径也要用绝对路径，或者处理App内部的资源路径
string scriptPath = "/Users/yourname/projects/script.py";
string args = $"\"{scriptPath}\"";

Process.StartInfo = new ProcessStartInfo("/bin/zsh", $"-c \"{pythonPath} {args}\"")
{
    RedirectStandardOutput = true,
    RedirectStandardError = true,
    UseShellExecute = false,
    CreateNoWindow = false,
    // 手动补充必要的PATH路径，避免其他依赖找不到
    EnvironmentVariables = { ["PATH"] = "/usr/bin:/usr/local/bin:/bin:/sbin" }
};

2. 配置沙箱权限（若启用沙箱） #

默认打包的Mac App会开启沙箱，需要在你的PropertyGroup里添加权限配置，允许执行子进程、继承环境变量：

<PropertyGroup>
    <!-- 保留你原有的所有配置 -->
    <NSAppleEventsUsageDescription>需要调用外部脚本完成功能</NSAppleEventsUsageDescription>
    <com.apple.security.app-sandbox>true</com.apple.security.app-sandbox>
    <com.apple.security.inherit-environment>true</com.apple.security.inherit-environment>
    <!-- 如果脚本需要访问网络，添加这个 -->
    <com.apple.security.network.client>true</com.apple.security.network.client>
    <!-- 如果需要读取用户选择的文件，添加这个 -->
    <com.apple.security.files.user-selected.read-write>true</com.apple.security.files.user-selected.read-write>
</PropertyGroup>

com.apple.security.inherit-environment会让App继承部分系统环境变量，能缓解PATH缺失的问题。

3. 处理App内嵌的Python脚本 #

如果脚本是打包在App内部的，得先获取App的实际运行路径来拼接脚本地址：

// 获取App包内的资源目录路径
string appContentsPath = Path.GetDirectoryName(AppContext.BaseDirectory);
string scriptPath = Path.Combine(appContentsPath, "Resources", "your_script.py");
// App包结构一般是：YourApp.app/Contents/MacOS/[可执行文件]，资源放在Contents/Resources下

4. 排查打包后的环境变量 #

可以在代码里加一行输出当前PATH，对比调试时的PATH，看缺了哪些路径：

Console.WriteLine($"当前PATH: {Environment.GetEnvironmentVariable("PATH")}");

打包运行后拿到输出，把缺失的必要路径补充到ProcessStartInfo.EnvironmentVariables里。

关于你现有PropertyGroup的补充说明 #

现有配置没有明显错误，但注意两点：

• CFBundleIconFile用.ico格式在Mac上可能显示异常，建议换成.icns格式的图标；
• 必须补充上述沙箱权限配置，否则子进程执行会受限。

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