PowerShell导出对象为CSV需区分对象管道与文本转换：ConvertTo-Csv生成CSV字符串并保留在管道中，Export-Csv则直接写入文件且不返回输出；推荐优先使用Export-Csv，需文本预处理时再用ConvertTo-Csv配合Out-File。
powershell 中导出对象为 csv 文件，核心在于理解 对象管道 与 文本格式转换 的区别。命令输出默认是结构化对象（有属性、方法），而 csv 是纯文本格式。直接保存对象会丢失结构信息，必须通过专门的转换或导出命令来完成。
ConvertTo-Csv 和 Export-Csv 的本质区别
-
ConvertTo-Csv把对象转成 CSV 字符串，结果仍留在 PowerShell 管道中，可继续传递给其他命令（比如Out-File、Set-Content或甚至ConvertFrom-Csv） -
Export-Csv一步到位：转换 + 写入文件，不返回任何对象到管道，执行后终端无输出
两者都处理对象的属性名作为列头，属性值作为行数据。
推荐用法：优先使用 Export-Csv
它简洁、可靠、专为导出设计：
Get-Service | Export-Csv -Path .\services.csv -NoTypeInformation
-
-NoTypeInformation去掉首行#TYPE ...（Windows PowerShell 5.1 默认带，PowerShell 6+ 默认不带） - 文件路径支持相对路径（如
.\data.csv）或绝对路径（如C:\temp\report.csv） - 若目标文件已存在，默认会被覆盖；加
-Force显式确认，或用-NoClobber防误覆盖
需要额外处理时用 ConvertTo-Csv + Out-File
适用于需在写入前做文本级操作（如追加、拼接、编码控制）：
Get-Process | ConvertTo-Csv -NoTypeInformation -Delimiter ';' | Out-File -FilePath .\processes.csv -Encoding UTF8
-
-Delimiter ';'指定分号分隔（适配某些地区 Excel 默认设置） -
-Encoding UTF8避免中文等字符乱码（Out-File默认是 Unicode，Export-Csv默认是 ASCII，但 PowerShell 6+ 默认 UTF8）
注意事项：导出后数据不可直接管道操作
CSV 文本不是对象，不能再用 Where-Object、Sort-Object 等处理。如需后续分析，应先 Import-Csv 还原为对象：
Windows TTS (WSL2)
下载
在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。
Import-Csv .\services.csv | Where-Object Status -eq 'Running' | Select-Object Name,Status
-
Import-Csv生成的是PSCustomObject，属性名来自 CSV 表头 - 如果原始 CSV 没有表头（如用了
-NoHeader），需手动用-Header参数指定列名
小技巧：快速查看导出效果（不落地）
调试时可跳过文件写入，直接看 CSV 内容：
Get-Date | ConvertTo-Csv -NoTypeInformation
终端立即打印 CSV 格式字符串，确认字段和格式是否符合预期。
不复杂但容易忽略
