脚本在PowerShell ISE可运行，控制台报错：HelpList未被识别为cmdlet

你碰到的这个坑其实是PowerShell执行机制的差异导致的。咱们先拆解下原因：
PowerShell控制台是逐行从上到下执行脚本的，当它运行到if($param1 -eq '' ) { HelpList }这一行时，HelpList函数还没被定义呢——它在脚本后面才声明，所以控制台自然会报错说这个命令不被识别。而PowerShell ISE在运行脚本前，会先预解析整个脚本的所有函数定义，提前把函数加载到内存里，所以执行起来就没问题。

给你两个简单的解决办法：

方案一：调整函数定义位置（最直接） #

把所有函数的定义移到脚本逻辑的前面，这样控制台执行到调用语句时，函数已经存在了：

function HelpList() { Write-Host "DevelopmentBuild.ps1 help" }
function clean() { Write-Host "Cleaning solution" }

param($param1 = '')
if($param1 -eq '' ) { HelpList }

方案二：用脚本块预加载函数（适合复杂脚本） #

如果你的脚本结构复杂，不想大动顺序，可以把函数打包到脚本块里提前执行：

# 先把函数定义放在脚本块里
$functionDefinitions = {
    function HelpList() { Write-Host "DevelopmentBuild.ps1 help" }
    function clean() { Write-Host "Cleaning solution" }
}
# 用点运算符执行脚本块，加载函数到当前会话
. $functionDefinitions

param($param1 = '')
if($param1 -eq '' ) { HelpList }

顺便提一句，以后写PowerShell脚本时，尽量把函数定义放在脚本开头，这样不管是在控制台还是ISE里运行，都能避免这类“命令未识别”的问题。

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