PowerShell模块嵌套重复导入问题求助：多目录脚本配置异常

问题分析 #

你遇到的重复导入问题，根源在于子模块配置中ScriptsToProcess的使用方式与模块嵌套逻辑的冲突：当父模块通过NestedModules加载子模块时，子模块的ScriptsToProcess会触发脚本的点源执行；如果同时存在其他配置路径（比如错误地在父模块中引用子模块的脚本），或者子模块的配置导致脚本被多次处理，就会出现函数重复定义的情况。

解决方案（两种规范实现方式） #

方式一：保留.ps1脚本文件，优化子模块配置 #

这种方式适合你希望每个函数单独存放在.ps1文件的场景：

1. 修改子模块的.psd1配置
   以GenericTests.psd1为例，确保只通过ScriptsToProcess加载脚本，并明确导出函数，避免自动发现的重复：

   @{
       ModuleVersion = '1.0.0'
       RootModule = $null  # 子模块无需根模块，仅处理脚本
       ScriptsToProcess = @(
           '.\GenericTest1.ps1',
           '.\GenericTest2.ps1'
       )
       # 明确列出要导出的函数，避免PowerShell自动导出时的重复识别
       FunctionsToExport = @('GenericTest1', 'GenericTest2')
       CmdletsToExport = '*'
       VariablesToExport = '*'
       AliasesToExport = '*'
   }
   

   SpecificTests.psd1做完全相同的配置，替换对应的脚本和函数名。

2. 在每个.ps1脚本中明确导出函数
   打开GenericTest1.ps1，在函数定义后添加导出语句：

   function GenericTest1 {
       # 你的函数逻辑
   }
   # 明确导出当前函数
   Export-ModuleMember -Function GenericTest1
   

   所有.ps1脚本都需要添加这行导出代码。

3. 根模块BuildTests.psd1保持现有配置
   确保根模块仅嵌套子模块的.psd1，不要引用任何.ps1文件：

   @{
       ModuleVersion = '1.0.0'
       RootModule = $null
       NestedModules = @(
           '.\GenericTests\GenericTests.psd1',
           '.\SpecificTests\SpecificTests.psd1'
       )
       FunctionsToExport = '*'  # 或者明确列出所有要对外暴露的函数
   }
   

方式二：改用.psm1模块文件（推荐最佳实践） #

这种方式更符合PowerShell模块的设计规范，每个函数作为独立的小模块存在：

1. 将.ps1重命名为.psm1
   把GenericTest1.ps1改成GenericTest1.psm1，GenericTest2.ps1改成GenericTest2.psm1，SpecificTests目录下的脚本同理。

2. 修改子模块的.psd1配置
   以GenericTests.psd1为例，通过NestedModules加载每个函数模块：

   @{
       ModuleVersion = '1.0.0'
       RootModule = $null
       NestedModules = @(
           '.\GenericTest1.psm1',
           '.\GenericTest2.psm1'
       )
       FunctionsToExport = @('GenericTest1', 'GenericTest2')
   }
   

3. 在每个.psm1中导出函数
   打开GenericTest1.psm1，添加导出语句（和方式一类似）：

   function GenericTest1 {
       # 你的函数逻辑
   }
   Export-ModuleMember -Function GenericTest1
   

4. 根模块配置不变
   依然保持NestedModules指向子模块的.psd1即可。

验证解决效果 #

先彻底卸载现有模块，避免缓存影响：

Get-Module BuildTests, GenericTests, SpecificTests | Remove-Module -Force

然后重新导入根模块：

Import-Module .\BuildTests\BuildTests.psd1 -Verbose

此时查看导出的函数，应该不会再出现重复：

Get-Command -Module BuildTests

内容的提问来源于stack exchange，提问作者Aurimas Stands with Ukraine