PowerShell中$PSScriptRoot点源子目录文件失效的排查与解决

为什么$PSScriptRoot没生效？ #

$PSScriptRoot是PowerShell的自动变量，仅当代码被保存为.ps1文件并执行（包括点源执行）时才会被赋值为脚本所在的目录路径。如果你的代码是直接在交互式控制台中粘贴运行，$PSScriptRoot会是空字符串，导致拼接的路径无效，自然找不到Functions目录下的脚本。

另外，即便脚本是文件形式，若执行脚本时的当前工作目录（$PWD）和脚本所在目录不一致，用.（当前目录）拼接路径的方式也会失效——因为.指向的是你运行脚本时所在的目录，而非脚本本身的目录。

排查与解决步骤 #

1. 先验证$PSScriptRoot的实际值 #

在脚本开头添加调试输出，确认变量是否正确赋值：

Write-Host "脚本所在目录：$PSScriptRoot"
$functionsPath = Join-Path -Path $PSScriptRoot -ChildPath "Functions"
Write-Host "目标函数目录：$functionsPath"

执行脚本后，如果输出为空或路径错误，说明脚本未以文件形式执行，或者执行方式异常。

2. 确保路径存在且能找到目标脚本 #

添加路径检查和明确的文件筛选，避免加载非.ps1文件或找不到目录：

$functionsPath = Join-Path -Path $PSScriptRoot -ChildPath "Functions"

# 检查目录是否存在
if (-not (Test-Path -Path $functionsPath -PathType Container)) {
    Write-Error "未找到Functions目录：$functionsPath"
    exit 1
}

# 仅加载.ps1文件，若需要递归加载子目录可加-Recurse参数
Get-ChildItem -Path $functionsPath -Filter "*.ps1" | ForEach-Object {
    Write-Host "正在加载脚本：$($_.FullName)"
    # 点源加载脚本
    . $_.FullName
}

3. 检查脚本执行方式 #

• 必须将代码保存为.ps1文件，比如Load-Functions.ps1
• 执行时，要么直接运行：.\Load-Functions.ps1（当前目录是脚本所在目录），要么用绝对路径运行，或者点源加载：. C:\path\to\Load-Functions.ps1

4. 验证函数是否真的在目标脚本中 #

确认Confirm-GamInstalled函数确实存在于Functions目录下的某个.ps1文件中，且函数名称拼写完全一致（PowerShell对大小写不敏感，但要注意空格和特殊字符）。

5. 检查执行策略（可选） #

如果遇到脚本无法加载的权限问题，可执行以下命令查看当前执行策略：

Get-ExecutionPolicy

若策略为Restricted，可临时调整为RemoteSigned（仅允许本地脚本执行）：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

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