如何构建PowerShell模块内部导入语句以适配部署场景？

问题场景 #

模块目录结构如下：

/.../foo
  foo.psd1  # New-ModuleManifest生成的默认清单文件
  foo.psm1  # 通过任务计划程序调用script.ps1
  script.ps1
  src/bar.ps1
  src/biz/baz.ps1

本地调试时从foo/目录运行一切正常，但模块打包部署后，script.ps1和bar.ps1中的相对路径导入语句全部失效。另外，这些文件是硬链接到主开发结构，理想状态下尽量不修改现有导入语句。

核心原因 #

本地调试时当前工作目录就是foo/，相对路径src/bar.ps1、src/biz/baz.ps1能正确指向目标文件；但模块部署后，导入模块或通过任务计划程序执行时，当前工作目录不一定是模块所在的foo/目录，导致相对路径无法定位到文件。

解决方案 #

方案1：无需修改导入语句（优先推荐） #

在script.ps1的最顶部添加以下代码，强制将当前工作目录切换到模块根目录：

# 获取模块根目录（script.ps1位于foo/下，其父目录即为模块根）
$moduleRoot = Split-Path -Path $PSScriptRoot -Parent
# 切换工作目录到模块根
Set-Location -Path $moduleRoot

原理：$PSScriptRoot是PowerShell自动变量，代表当前脚本文件的所在目录。通过该变量定位到模块根目录并切换后，后续所有相对路径导入的逻辑就和本地调试时完全一致，无需修改任何现有导入语句。

当script.ps1调用bar.ps1时，bar.ps1的执行上下文工作目录已经是模块根，因此bar.ps1中的src/biz/baz.ps1也能正确找到目标文件。

方案2：使用绝对路径导入（需少量修改语句） #

如果可以接受修改导入语句，推荐用$PSScriptRoot构建绝对路径，避免依赖工作目录：

• 修改script.ps1中的导入语句：

. (Join-Path -Path $PSScriptRoot -ChildPath 'src/bar.ps1')
. (Join-Path -Path $PSScriptRoot -ChildPath 'src/biz/baz.ps1')

• 修改bar.ps1中的导入语句：

. (Join-Path -Path $PSScriptRoot -ChildPath 'biz/baz.ps1')

原理：通过Join-Path结合$PSScriptRoot生成目标文件的绝对路径，无论当前工作目录是什么，都能精准定位到文件，稳定性更强。

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