终版

clear_qt_cache.ps1

@@ -8,12 +8,14 @@ param(
 Set-StrictMode -Version 2.0
 $ErrorActionPreference = 'Stop'
 
+# 函数作用：将传入路径解析为规范化的绝对路径，便于后续安全校验和文件删除操作。
 function Resolve-FullPath {
     param([Parameter(Mandatory = $true)][string]$Path)
 
     return [IO.Path]::GetFullPath((Resolve-Path -LiteralPath $Path).Path)
 }
 
+# 函数作用：确认待删除目标位于指定项目目录内部，避免误删项目外部文件。
 function Assert-InsideDirectory {
     param(
         [Parameter(Mandatory = $true)][string]$Parent,
@@ -29,6 +31,7 @@ function Assert-InsideDirectory {
     }
 }
 
+# 函数作用：检查 Qt Creator、CMake、Ninja 等构建相关进程是否正在运行，防止清理缓存时与构建过程冲突。
 function Stop-IfBuildToolsAreRunning {
     $names = @('qtcreator', 'cmake', 'ninja', 'jom', 'mingw32-make', 'make')
     $running = Get-Process -ErrorAction SilentlyContinue |
@@ -41,6 +44,7 @@ function Stop-IfBuildToolsAreRunning {
     }
 }
 
+# 函数作用：收集当前 Qt 项目下可安全清理的 CMake/Qt Creator 缓存文件和构建目录，并去除重复项。
 function Get-CacheTargets {
     param([Parameter(Mandatory = $true)][string]$ProjectPath)