PowerShell函数间变量传递及PSCustomObject数组循环问题解决

一、解决$archivo在CREAR_DOCWORD中为空的问题 #

问题根源通常是参数传递不明确，或函数参数定义存在绑定/作用域问题，修复方式如下：

1. 明确函数参数定义
   给两个函数的参数加上强制标记和类型约束，避免参数绑定失败：

function EXTRAER_DATA_COMIDA_Y_CREAR_WORD {
    param(
        [Parameter(Mandatory=$true)]
        [ValidateScript({Test-Path $_})]
        [string]$archivo
    )
    # 此处编写处理文件生成$result的逻辑
    $result = ...
    # 调用时使用命名参数传递，避免位置参数歧义
    CREAR_DOCWORD -Resultado $result -Archivo $archivo
}

function CREAR_DOCWORD {
    param(
        [Parameter(Mandatory=$true)]
        $Resultado,
        [Parameter(Mandatory=$true)]
        [string]$Archivo
    )
    # 此处编写生成Word文档的逻辑
    Write-Host "当前处理文件：$Archivo"
}

2. 调用时避免隐式参数传递
   不要依赖位置参数的顺序，始终用-参数名 值的方式传递，确保参数不会被遗漏或错位。

二、解决System.Management.Automation.PSCustomObject无法用for循环遍历的问题 #

PSCustomObject是单个对象（无Length/Count属性），需根据实际场景调整遍历方式：

场景1：$COMIDA是单个PSCustomObject #

直接访问对象属性即可；如果要统一集合处理逻辑，可将其转为单元素数组：

# 强制转为数组
$COMIDA = @($COMIDA)
# 此时可用for循环（基于索引）
for ($i = 0; $i -lt $COMIDA.Count; $i++) {
    $item = $COMIDA[$i]
    Write-Host "食物名称：$($item.Nombre)，热量：$($item.Calorias)"
}

场景2：$COMIDA是PSCustomObject集合（但被识别为单个对象） #

很多PowerShell命令返回单个对象时不会自动转为数组，需用@()强制包装：

# 示例：从CSV读取数据时强制转为数组
$COMIDA = @(Import-Csv -Path "comidas.csv")
# 推荐使用foreach循环（更符合PowerShell习惯）
foreach ($comida in $COMIDA) {
    Write-Host "处理食物：$($comida.Nombre)"
}

注意：优先使用foreach遍历集合 #

PowerShell中针对对象集合，foreach循环比基于索引的for循环更简洁且不易出错，除非你需要明确的索引值。

内容的提问来源于stack exchange，提问作者Juan Manuel Sanchez