如何让自定义PowerShell模块在会话启动时自动加载？已按文档部署仍失败

问题本质 #

PowerShell 5.1默认不会自动加载模块，仅当触发模块自动发现条件（比如执行Get-Command -Module <模块名>）时才会加载模块。你遇到的现象是该默认行为的典型表现。

解决方法1：修改模块清单启用自动加载 #

• 找到模块的.psd1清单文件，确保RootModule字段指向正确的.psm1模块文件
• 添加或修改AutoLoadFunctions字段，列出需要自动暴露的函数名称，示例：

  AutoLoadFunctions = @('Get-MyCustomFunc', 'Set-MyCustomConfig')
  

• 保存文件后重启PowerShell会话，函数即可直接调用。

解决方法2：通过配置文件强制加载模块 #

• 针对所有用户：编辑公共配置文件 C:\Program Files\WindowsPowerShell\profile.ps1
• 针对单个用户：编辑用户配置文件 $HOME\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1
• 在配置文件中添加强制加载命令：

  Import-Module -Name <你的模块名> -Force
  

• 保存配置文件后，重启PowerShell模块会自动加载。

解决方法3：检查模块目录结构规范 #

• 模块根目录名称必须与.psd1文件名完全一致，正确结构示例：

  C:\Program Files\WindowsPowerShell\Modules\MyCustomModule
  ├─ MyCustomModule.psd1
  └─ MyCustomModule.psm1
  

• 目录名与模块名不匹配会导致PowerShell无法识别为可自动加载模块。

额外排查点 #

• 执行$env:PSModulePath确认你的模块目录在路径列表内
• 执行Get-Module -ListAvailable检查模块是否被PowerShell识别为可用模块
• 执行Import-Module <模块完整路径> -Verbose查看加载日志，排查语法或路径错误

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