求助：GCE Windows启动脚本从GCS桶加载时出现解析错误

我之前帮好几个用户排查过类似的问题——本地跑没问题、传Gist正常但GCS加载就报错，大概率是换行符格式不兼容或者文件编码带BOM搞的鬼，毕竟GCE的启动脚本执行环境（哪怕是Windows实例）对文件格式的要求比本地PowerShell更严格。下面是具体的排查和解决步骤：

1. 转换脚本的换行符为Unix风格（LF） #

本地编写的PowerShell脚本默认用的是Windows风格的CRLF换行，但GCE在加载启动脚本时，可能会把CR当成脚本内容的一部分，导致语法解析错误。你可以这样处理：

• 用PowerShell命令直接转换：

  (Get-Content .\your-script.ps1) -join "`n" | Set-Content .\your-script.ps1 -NoNewline -Encoding utf8
  

• 或者用VS Code这类编辑器：打开脚本后，点击右下角的CRLF标识，切换为LF，再保存文件。

2. 确保脚本编码为UTF-8无BOM #

Windows默认保存的PowerShell脚本可能是UTF-16或者带BOM的UTF-8格式，GCE的脚本解析器对带BOM的文件很敏感，容易触发解析错误。转换方法：

• PowerShell命令转换：

  Get-Content .\your-script.ps1 -Encoding Unicode | Set-Content .\your-script.ps1 -Encoding UTF8
  

• VS Code操作：点击右下角的编码标识，选择"通过编码保存"，再选"UTF-8"（不要选带BOM的选项）。

3. 验证GCS中的文件内容 #

转换后重新上传GCS，然后用gsutil命令查看云端的脚本内容，确认没有异常：

gsutil cat gs://your-bucket-path/your-script.ps1

对比本地脚本，看看有没有多出奇怪的字符或者换行异常。

4. 附加调试技巧（定位具体错误） #

如果还是有问题，可以在启动脚本开头加一行调试命令，让串行控制台输出更详细的执行日志：

Set-PSDebug -Trace 1

或者换一种加载方式：先把脚本下载到实例本地再执行，避免GCE直接加载时的格式处理问题：

Invoke-WebRequest -Uri "gs://your-bucket-path/your-script.ps1" -OutFile "C:\temp\local-script.ps1"
& "C:\temp\local-script.ps1"

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