Chef食谱中复杂PowerShell脚本上传失败，报Ruby语法错误求助

这个问题不是Chef的固有特性，而是Ruby解析Here文档时和PowerShell语法的冲突导致的，很容易解决，我来一步步给你讲清楚：

问题根源 #

你写的Here文档（<<-EOH）是Ruby的双引号风格解析模式，Ruby会尝试解析里面的$符号（比如PowerShell里的$True）作为Ruby变量，但$True在Ruby里不是合法的变量名（Ruby里布尔值是小写的true），所以直接触发了语法错误，而且因为Chef的错误提示不够详细，才会只显示笼统的语法错误信息。

解决方法 #

1. 使用单引号风格的Here文档 #

把Here文档的标记改成<<-'EOH'（注意单引号），这样Ruby会完全忽略里面的变量解析，直接把内容原封不动传给PowerShell执行：

powershell_script 'Install' do
  code <<-'EOH'
    If ((Test-Path D:\Chef) -eq $True) {
      # 这里写你的PowerShell逻辑
      Write-Host "Chef directory exists"
    }
  EOH
end

这是最直接的修复方式，适合嵌入简短的PowerShell代码。

2. 转义PowerShell中的美元符号 #

如果必须使用双引号风格的Here文档（比如需要插入Ruby变量到PowerShell代码里），可以把PowerShell里的$转义成\$，让Ruby不把它当成变量：

powershell_script 'Install' do
  code <<-EOH
    If ((Test-Path D:\\Chef) -eq \\$True) {
      Write-Host "Chef directory exists"
    }
  EOH
end

这种方式适合需要混合Ruby和PowerShell变量的场景，但代码可读性会稍差。

3. 引用外部PowerShell脚本文件 #

对于复杂的PowerShell逻辑，更推荐把脚本单独存成.ps1文件（比如放在食谱的files/default/目录下），然后用powershell_script的source属性引用：

powershell_script 'Install' do
  source 'install_script.ps1'
end

这种方式完全避免了Ruby和PowerShell的语法冲突，脚本也更易维护和调试，适合复杂的脚本逻辑。

额外提示 #

如果之后还是遇到语法错误，可以尝试用Ruby的语法检查工具（比如ruby -c your_cookbook_file.rb）单独检查食谱文件，能得到更详细的错误位置和信息，帮助快速定位问题。

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