Test-Path 是什么
Test-Path 判断路径是否存在，返回布尔值：文件、目录、注册表项、证书容器乃至环境变量驱动的路径都可以测。它最常见的用途是脚本前置校验——先把结果存进变量，再做分支处理，实现「不存在就创建」这类幂等逻辑。还有两种容易被忽略的用法：限定路径类型，区分文件与目录；以及只校验路径写法是否合法而不关心它是否存在。掌握这两点能让校验逻辑更精确。
基本信息
| 适用平台 | Windows PowerShell 5.1 与 PowerShell 7 及以上 |
|---|---|
| 语法 | Test-Path [-Path] <路径> [-PathType Leaf|Container|Any] [-IsValid] |
| 返回值 | 布尔值，真表示存在或写法合法 |
| 类型限定 | Leaf 表示文件或末级项，Container 表示目录类容器 |
| 语法校验 | 仅校验路径格式是否合法，不判断是否存在 |
| 适用路径 | 文件系统、注册表、证书、环境变量等提供程序下的路径 |
典型使用场景
- 脚本前置校验：目标目录不存在时先创建，避免后续命令报错
- 幂等处理：重复执行任务时不因目标已存在而失败
- 区分类型：确认同名对象是文件还是目录，决定后续动作
- 校验用户输入的路径写法是否合法，提前给出提示
- 检查注册表项是否存在，再决定是否写入配置
- 配合条件判断做分支与日志记录，让脚本可观测
常用示例
常用示例
# 基本判断并分支
if (Test-Path D:\Backup) { '存在' } else { '缺失' }
# 区分类型
Test-Path D:\Backup -PathType Container
Test-Path D:\Backup\app.log -PathType Leaf
# 只校验写法是否合法
Test-Path 'D:\a<>b' -IsValid
# 校验注册表项
Test-Path HKLM:\SOFTWARE\Microsoft\Windows -PathType Container
# 幂等创建：不存在才建
if (-not (Test-Path D:\Logs\App)) { New-Item -Path D:\Logs\App -ItemType Directory -Force }
# 对多个路径批量判断
'D:\a','D:\b' | ForEach-Object { [pscustomobject]@{ 路径 = $_; 存在 = Test-Path $_ } }参数与用法
| 参数 | 作用 | 注意点 |
|---|---|---|
| -Path | 要判断的路径 | 支持通配符，也可从管道传入 |
| -PathType Leaf | 限定为文件或末级项 | 目录会返回假 |
| -PathType Container | 限定为容器类 | 文件的父目录判定为真 |
| -IsValid | 只校验路径语法 | 不访问目标，因此不受权限影响 |
| -LiteralPath | 按字面处理含通配符的路径 | 路径里带方括号时使用 |
| -ErrorAction | 控制错误行为 | 权限不足时可能直接报错 |
路径里包含方括号等通配符字符时会被当作模式解释，结果与预期不符，此时应改用按字面处理的参数，或先转义这些字符。
无权限访问的路径有时会直接抛出错误而不是返回假，脚本里建议用异常处理包裹，或先把错误行为设为静默再显式判断结果。