1. 引言

在 Windows 系统管理和自动化脚本编写中，PowerShell 是功能强大的工具。无论是访问文件、加载模块，还是执行脚本，都离不开对路径的正确理解和处理。PowerShell 的路径规则与传统的 CMD 有所不同，它更灵活，但也更复杂。掌握这些规则，能帮助你避免常见的“找不到路径”错误，编写出更健壮、可移植的脚本。

本文将系统性地介绍 PowerShell 中的路径规则，涵盖基础概念、路径类型、特殊字符处理、相对与绝对路径、路径操作 cmdlet 以及最佳实践。

2. 路径基础概念

2.1 什么是路径？

路径（Path）是用于定位文件或目录（文件夹）在文件系统中位置的字符串。在 PowerShell 中，路径通常用于Get-Content、Set-Location、Copy-Item等 cmdlet 的参数。

2.2 路径分隔符

• 反斜杠（\）：Windows 传统的路径分隔符。例如：C:\Users\Admin\Documents。
• 正斜杠（/）：PowerShell 也支持正斜杠作为分隔符，这借鉴了 Unix/Linux 的风格，提高了跨平台脚本的可读性。例如：C:/Users/Admin/Documents。

最佳实践：在 PowerShell 脚本中，建议使用反斜杠（\），因为它是 Windows 原生格式，与大多数其他 Windows 工具和 API 兼容。但在处理来自网络或跨平台环境的路径时，正斜杠可能更方便。

3. 路径类型详解

3.1 绝对路径

绝对路径从驱动器根目录（或网络共享根目录）开始，完整地指定了文件或目录的位置。它不依赖于当前工作目录。

# 本地绝对路径示例 C:\Windows\System32\notepad.exe D:\Projects\Scripts\main.ps1 网络绝对路径示例 \Server01\SharedFolder\Report.pdf

3.2 相对路径

相对路径是相对于当前工作目录（由Get-Location$PWD 变量获取）的路径。使用相对路径可以使脚本更具可移植性。

# 假设当前目录是 C:\Users\Admin .\Desktop\file.txt # 指向 C:\Users\Admin\Desktop\file.txt ..\Public\Documents # 指向 C:\Users\Public\Documents Scripts\config.ini # 指向 C:\Users\Admin\Scripts\config.ini (省略了.\)

特殊符号：

• .（单点）：代表当前目录。
• ..（双点）：代表父目录。

3.3 PowerShell 特定路径

PowerShell 提供了一些变量来快速访问特殊路径：

• $HOME：当前用户的主目录（例如：C:\Users\Admin）。
• $PSScriptRoot：极其重要。包含当前正在执行的脚本文件所在的目录路径。在脚本内部使用它来引用与脚本同目录的其他文件，可以确保脚本无论从何处被调用，都能找到正确路径。
• $PSHOME：PowerShell 的安装目录。
• $env:TEMP或$env:TMP：系统的临时目录。

# 在脚本中引用同级目录的配置文件 $configPath = Join-Path $PSScriptRoot "config.json" $configData = Get-Content $configPath

4. 路径中的特殊字符与转义

4.1 空格与括号

如果路径中包含空格或圆括号()，必须用引号将整个路径括起来，或者使用转义字符`（反引号，Backtick）。

# 路径包含空格 $path1 = "C:\Program Files\PowerShell\7\pwsh.exe" $path2 = C:\Program` Files\PowerShell`\7\pwsh.exe 路径包含括号 $path3 = "C:\Users\Admin\My (Important) Files\doc.txt" $path4 = C:\Users\Admin\My (Important) Files\doc.txt

建议：始终使用引号，这样更清晰、更安全。

4.2 通配符

PowerShell 支持在路径中使用通配符进行模式匹配，常用于Get-ChildItem、Remove-Item等 cmdlet。

• *：匹配任意数量的字符（包括零个）。
• ?：匹配任意单个字符。
• [ ]：匹配指定范围内的字符。

# 获取当前目录下所有 .txt 文件 Get-ChildItem *.txt 获取文件名以 "log" 开头，扩展名为 .log 或 .txt 的文件 Get-ChildItem log*.[lt]

注意：如果路径中的星号或问号是字面意思（例如文件名中确实包含这些字符），则需要使用`进行转义，或者使用-LiteralPath参数。

5. 路径操作与解析

5.1 常用路径操作 Cmdlet

• Join-Path：将路径片段安全地组合成一个路径。这是构建路径的首选方法，它能自动处理分隔符。
• Split-Path：从路径中提取父目录、叶子名称或扩展名等部分。
• Resolve-Path：将相对路径或包含通配符的路径解析为绝对路径。
• Convert-Path：将 PowerShell 路径（如包含提供程序前缀的路径）转换为原生文件系统路径。
• Test-Path：检查路径是否存在，是文件还是目录。

# 使用 Join-Path 安全构建路径 $base = "C:\Data" $file = "report.csv" $fullPath = Join-Path $base $file # 结果为 C:\Data\report.csv 使用 Split-Path 提取部分 $parent = Split-Path $fullPath -Parent # C:\Data $leaf = Split-Path $fullPath -Leaf # report.csv 使用 Test-Path 进行检查 if (Test-Path $fullPath -PathType Leaf) { Write-Host "文件存在。" }

5.2 路径提供程序与 PSDrive

PowerShell 不仅操作文件系统，还通过“提供程序”（Provider）访问其他数据存储，如注册表 (HKLM:,HKCU:)、证书存储 (Cert:)、变量 (Variable:) 等。这些位置被称为“PSDrive”。

# 访问注册表 Set-Location HKLM:\Software\Microsoft Get-ChildItem 访问环境变量 Get-ChildItem Env:\ | Where-Object Name -like "PATH*"

处理这些路径时，规则与文件系统路径类似，但前缀（如HKLM:）是必需的。

6. 常见问题与最佳实践

6.1 路径找不到的常见原因

1. 拼写错误或大小写不敏感：虽然 Windows 路径通常不区分大小写，但精确拼写是必须的。
2. 未转义特殊字符：路径中的空格、括号未用引号包裹或转义。
3. 使用相对路径时，当前目录非预期：脚本被其他脚本调用时，$PWD可能改变。始终使用$PSScriptRoot来定位脚本相关资源。
4. 权限不足：尝试访问系统目录或受保护的文件。

6.2 最佳实践总结

• 使用Join-Path：避免手动拼接字符串，防止多余或缺失分隔符。
• 脚本内使用$PSScriptRoot：这是确保脚本可移植性的黄金法则。
• 引号包裹路径：只要路径可能包含空格或特殊字符，就使用双引号。
• 检查路径存在性：在对路径进行操作（读、写、删）前，使用Test-Path进行验证。
• 明确使用-Path或-LiteralPath：当路径包含通配符但你需要字面匹配时，使用-LiteralPath参数。
• 统一分隔符风格：在项目或团队内部约定使用反斜杠（\）或正斜杠（/），并保持一致。

7. 总结

PowerShell 的路径规则是其强大文件操作能力的基础。理解绝对路径与相对路径的区别、掌握$PSScriptRoot等特殊变量的用法、熟练运用Join-Path和Test-Path等 cmdlet，能够显著提升脚本的健壮性和可维护性。记住，处理路径时，“显式优于隐式”，明确地构建和检查路径，是避免错误的关键。

希望本文能帮助你彻底理清 PowerShell 中的路径规则，让你的自动化之旅更加顺畅。