PowerShell自定义模块导入后无法访问成员，加-Force才生效求助

你遇到的CommandNotFoundException错误，核心原因是PowerShell的模块缓存机制，加上模块导出定义的潜在不一致：

1. 模块缓存过期：PowerShell会在首次导入模块时缓存模块的导出信息（比如哪些函数对外可见）。如果之前你导入过旧版本的StuiterModule（比如当时FunctionsToExport里还没包含Invoke-Reboot），或者缓存文件损坏，那么即使你更新了模块代码，不加-Force参数时，PowerShell依然会读取旧的缓存信息，导致它认为模块没有导出Invoke-Reboot命令。

2. 导出定义的双重校验：你的模块同时通过psd1文件的FunctionsToExport和psm1里的Export-ModuleMember定义了导出函数。虽然你现在的两个定义是一致的（psd1里列了Invoke-Reboot，psm1导出了Public文件夹下的所有函数名），但如果之前存在过两者不一致的情况，缓存就会保留错误的导出列表，只有-Force会强制PowerShell重新解析模块的实际导出内容。

1. 清除PowerShell模块缓存 #

这是最直接解决缓存问题的方法：

• 关闭所有正在运行的PowerShell窗口（包括ISE、终端等）
• 删除模块缓存文件，路径为：

  $env:LOCALAPPDATA\Microsoft\Windows\PowerShell\ModuleAnalysisCache
  

  或者打开一个新的PowerShell窗口（以管理员身份，确保没有其他PS进程占用该文件），执行：

  Remove-Item -Path $env:LOCALAPPDATA\Microsoft\Windows\PowerShell\ModuleAnalysisCache -Force
  

2. 确保导出定义完全同步 #

虽然你现在的psd1和psm1导出是一致的，但为了避免后续出现类似问题，建议让两者的导出逻辑保持统一：

• 如果你想通过psm1自动导出Public文件夹的函数，可以修改psd1的FunctionsToExport为动态获取（注意：psd1是静态文件，每次添加新函数后需要重新生成或手动更新）：

  FunctionsToExport = (Get-ChildItem -Path "$PSScriptRoot\Public\*.ps1").BaseName
  

• 或者保持psd1手动列出所有导出函数，每次添加新函数时同步更新这个列表，确保和Public文件夹里的函数一一对应。

3. 验证模块结构正确性 #

确认你的模块文件夹结构完全符合PowerShell的要求：

C:\Program Files\WindowsPowerShell\Modules\StuiterModule\
├─ StuiterModule.psd1
├─ StuiterModule.psm1
├─ Public\
│  └─ Invoke-Reboot.ps1
│  └─ Start-Program.ps1
│  └─ Update-Program.ps1
└─ Private\

如果模块嵌套在额外的子文件夹里（比如StuiterModule\StuiterModule\），PowerShell可能无法正确识别模块，也会导致导入异常。

完成以上步骤后，重新打开PowerShell，直接执行Import-Module StuiterModule -Verbose，应该就能正常调用Invoke-Reboot了，不需要再加-Force参数。

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