PowerShell搭配WPF GUI执行PlatformFileCopy时脚本与界面冻结

• 最核心的触发机制：PowerShell 承载的 WPF GUI 默认运行在单STA主线程上，整个界面依赖主线程的消息循环处理点击、重绘等交互。PlatformFileCopy中涉及的SharePoint PnP文件复制逻辑默认是同步阻塞实现，涉及网络IO、大文件传输、身份校验的耗时操作会持续占用UI线程，直接打断消息循环，导致脚本和界面整体冻结。
• 纯脚本环境无感知的原因：无WPF界面时不存在消息循环的交互约束，代码同步阻塞主线程只会表现为执行等待，不会触发“界面冻结”的交互问题，因此单脚本运行全功能正常。
• 前置函数运行正常的原因：ClientFolderTicketFolderAndPlatform通常是本地目录遍历、配置读取这类轻量操作，单次执行耗时极短，对UI线程的阻塞在用户感知阈值以下，不会触发卡死；而PnP跨网络文件复制的耗时从数秒到数分钟不等，长时阻塞必然触发界面无响应。
• 合并函数后问题复现的逻辑：纯脚本运行时无UI消息循环，合并后的代码同步执行也不会产生冻结反馈；但带GUI运行时，只要长时PnP复制逻辑还在UI线程的执行路径上，无论是否拆分函数、是否合并代码，都会出现冻结。

• 在PlatformFileCopy函数入口添加一行测试弹窗代码[System.Windows.MessageBox]::Show("进入复制函数")：如果弹窗弹出后直接无响应，直到整个文件复制流程走完后弹窗才可交互，即可直接确认是UI线程阻塞问题，和PnP逻辑本身的正确性无关。
• 临时把复制逻辑通过Start-Job放到后台进程执行，观察界面是否还会冻结：如果后台执行时界面全程可交互、复制流程正常完成，即可100%锁定根因。

• 在WPF按钮的点击事件回调中直接同步调用PnP复制方法，没有拆分后台执行逻辑
• 使用PnP默认的同步版Copy-PnPFile实现，没有通过独立Runspace或后台作业承载长时IO操作
• 合并两个函数时没有调整执行线程，仅做了代码块拼接，长时IO逻辑依然留在UI线程执行路径上

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