PowerShell中Start-Process调用Unity批处理模式进程挂起无退出问题

核心原因分析 #

1. 构建脚本未显式退出Unity进程：Unity批处理模式（-batchmode）不会在执行完-executeMethod指定的方法后自动退出，必须通过代码主动触发退出逻辑。手动在Unity编辑器中运行构建时，编辑器处于交互模式不会自动关闭，但批处理模式下进程会一直驻留，直到收到退出指令。
2. 输出缓冲区阻塞：使用-NoNewWindow参数时，Unity的大量日志输出可能填满PowerShell的输出缓冲区，导致进程等待缓冲区被读取，进而挂起。
3. 缺失关键批处理参数：未添加-quit或-nographics等参数，部分Unity版本需要这些参数确保批处理流程正常收尾。

解决方法 #

1. 修改Unity构建脚本，添加显式退出逻辑 #

在BuildProject方法的末尾，无论构建成功或失败，都添加退出代码：

using UnityEditor;

public static class BuildScript
{
    public static void BuildProject()
    {
        // 你的构建逻辑...
        
        // 构建完成后显式退出Unity，0表示成功，非0表示失败
        EditorApplication.Exit(0);
        // 若使用Unity 2019及以上版本，也可通过ExitCode设置退出码后再退出：
        // EditorApplication.ExitCode = 0;
        // EditorApplication.Exit();
    }
}

2. 优化PowerShell脚本参数 #

添加-quit参数确保Unity执行完方法后退出，同时使用-logFile将日志输出到文件，避免缓冲区阻塞：

$UnityPath = "C:\Program Files\Unity\Hub\Editor\2023.1.17f1\Editor\Unity.exe"
$BuildMethod = "Assets.Scripts.Editor.BuildScript.BuildProject"
$LogPath = ".\Unity_Build_Log.txt"

Write-Host "Building project..."
# 添加-quit和-logFile参数，移除可能导致缓冲区问题的-NoNewWindow
$process = Start-Process -FilePath $UnityPath -ArgumentList "-batchmode", "-nographics", "-executeMethod", $BuildMethod, "-quit", "-logFile", $LogPath -PassThru -Wait
$exitCode = $process.ExitCode
Write-Host "Unity process exited with code: $exitCode"

注：-nographics参数可避免Unity加载图形组件，进一步减少批处理模式下的潜在问题。

3. 直接在命令行测试（排除PowerShell问题） #

打开CMD窗口，运行以下命令，验证Unity进程是否能正常退出：

"C:\Program Files\Unity\Hub\Editor\2023.1.17f1\Editor\Unity.exe" -batchmode -nographics -executeMethod Assets.Scripts.Editor.BuildScript.BuildProject -quit -logFile build.log

如果此命令能正常退出，说明问题出在PowerShell的参数配置上；如果依然挂起，问题则在Unity构建脚本或编辑器本身。

排查建议 #

• 检查异步/后台任务：确认构建脚本中没有未完成的协程、异步操作或后台线程，这些会阻止Unity进程退出。
• 查看完整日志：通过-logFile生成的日志文件，检查是否有隐藏的错误、警告或资源加载问题，即使构建成功提示出现，也可能存在未处理的后台问题。
• 测试不同Unity版本：部分版本存在批处理模式的已知bug，尝试升级或降级到稳定版本验证问题是否消失。
• 检查权限：确保PowerShell脚本和Unity编辑器有足够的文件系统权限（比如写入构建输出目录、日志文件目录的权限）。

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