PowerShell主脚本调用子函数的合理查找方式及最佳实践咨询

首选方案：基于主脚本路径的相对寻址 #

$PSScriptRoot是PowerShell 3.0及以上版本内置的自动变量，指向当前运行脚本所在目录的绝对路径。只要你项目内部的目录结构固定，不管整个项目文件夹迁移到任何位置，都能正常找到子函数，不需要硬编码路径。

假设你的项目目录结构如下：

C:\main\
├─ Xfunction.ps1  # 主脚本
└─ child_scripts\ # 子函数统一存放目录
   ├─ FunA.ps1
   └─ FunB.ps1

主脚本里导入子函数的代码直接写：

# 拼接子函数的绝对路径
$funAPath = Join-Path -Path $PSScriptRoot -ChildPath "child_scripts\FunA.ps1"
Import-Module $funAPath

优化的动态搜索方案 #

如果你确实有动态查找子函数的需求，不要全磁盘递归扫描，一方面性能极低，另一方面容易命中重名的恶意脚本，存在安全风险。建议优先限定搜索范围为主脚本所在目录及其子目录，其次搜索PowerShell默认的模块路径$env:PSModulePath，示例代码：

$ChildFun = "你要找的子函数文件名"
# 第一步：在主脚本目录下搜索
$targetFile = Get-ChildItem -Path $PSScriptRoot -Filter "$ChildFun.ps1" -File -Recurse -ErrorAction SilentlyContinue | Select-Object -First 1
# 第二步：没找到再去系统模块路径搜索
if (-not $targetFile) {
    $modulePaths = $env:PSModulePath -split ';'
    $targetFile = Get-ChildItem -Path $modulePaths -Filter "$ChildFun.ps1" -File -Recurse -ErrorAction SilentlyContinue | Select-Object -First 1
}
# 导入逻辑
if ($targetFile) {
    Import-Module $targetFile.FullName
} else {
    throw "未找到指定的子函数脚本：$ChildFun"
}

行业通用最佳实践 #

• 普通项目优先固定内部目录结构，使用$PSScriptRoot做相对路径导入，性能最高、稳定性最好，适配绝大多数场景
• 如果你开发的是可分发的通用工具，将子函数封装为标准PowerShell模块（包含.psm1逻辑文件和.psd1清单文件），放到$env:PSModulePath包含的目录下，Import-Module直接通过模块名即可导入，不需要写路径
• 子函数和主脚本耦合度极高的场景，可以直接把子函数的定义合并到主脚本中，彻底规避寻址问题
• 禁止无差别全磁盘递归搜索脚本，避免不必要的性能损耗和安全隐患

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