命令行与文本处理 / 系统课时
导入与导出 CSV
导入与导出 CSV
CSV 看似只是文本文件,但可靠处理必须同时控制列名、分隔符、编码和字段类型。本课将完成一次读取、类型转换、筛选、导出与内存转换流程,并建立可重复的结果验证方法。
学习目标
- 使用
Import-Csv、Export-Csv和ConvertTo-Csv完成表格数据往返处理 - 正确处理自定义分隔符、UTF-8 编码和字段类型转换
- 通过重新导入与显式输出验证导出结果
CSV 在 PowerShell 中的对象模型
Import-Csv 会把每一行转换为一个 PSCustomObject,表头成为属性名。CSV 本身不保存数据类型,因此数量、金额和日期导入后通常都是字符串;直接排序或计算可能得到错误结果,例如字符串 "10" 会排在 "2" 前面。
Export-Csv 接收对象并写出其属性。应在导出前完成筛选、计算和字段整形,不要先经过 Format-Table,因为格式化命令产生的是显示对象,而不是原始业务对象。ConvertTo-Csv 使用相同的序列化规则,但返回 CSV 文本,适合发送接口、写入日志或继续加工。
完成一次导入、转换与导出
下面的脚本创建示例文件,将数量、金额和日期转换为真实类型,筛选数量不少于 2 的记录,再使用分号导出。同时用 ConvertTo-Csv 在控制台预览相同内容。
$sourcePath = Join-Path $PWD 'orders.csv'
$targetPath = Join-Path $PWD 'orders-filtered.csv'
@'
Name,Quantity,Amount,OrderDate
键盘,2,128.50,2026-08-01
显示器,1,999.00,2026-08-02
鼠标,3,89.90,2026-08-03
'@ | Set-Content -Path $sourcePath -Encoding utf8
$rows = Import-Csv -Path $sourcePath -Encoding utf8
$typedRows = $rows | ForEach-Object {
$amount = [decimal]::Parse(
$_.Amount,
[System.Globalization.CultureInfo]::InvariantCulture
)
$orderDate = [datetime]::ParseExact(
$_.OrderDate,
'yyyy-MM-dd',
[System.Globalization.CultureInfo]::InvariantCulture
)
[pscustomobject]@{
Name = $_.Name
Quantity = [int]$_.Quantity
Amount = $amount
OrderDate = $orderDate
}
}
$selectedRows = $typedRows | Where-Object Quantity -ge 2
$exportRows = $selectedRows | ForEach-Object {
[pscustomobject]@{
Name = $_.Name
Quantity = $_.Quantity
Amount = $_.Amount.ToString(
'0.00',
[System.Globalization.CultureInfo]::InvariantCulture
)
OrderDate = $_.OrderDate.ToString('yyyy-MM-dd')
}
}
$exportRows | Export-Csv `
-Path $targetPath `
-Delimiter ';' `
-Encoding utf8 `
-NoTypeInformation
$first = $typedRows[0]
"第一行类型: Quantity=$($first.Quantity.GetType().Name), Amount=$($first.Amount.GetType().Name), OrderDate=$($first.OrderDate.GetType().Name)"
"筛选后记录数: $($exportRows.Count)"
$exportRows | ConvertTo-Csv -Delimiter ';' -NoTypeInformation预期输出:
第一行类型: Quantity=Int32, Amount=Decimal, OrderDate=DateTime
筛选后记录数: 2
"Name";"Quantity";"Amount";"OrderDate"
"键盘";"2";"128.50";"2026-08-01"
"鼠标";"3";"89.90";"2026-08-03"脚本会在当前目录生成 orders.csv 和 orders-filtered.csv。实际目录由运行位置决定,但控制台内容应与上方一致。
分隔符、编码与字段边界
默认分隔符是逗号。遇到分号、制表符等格式时,导入和导出必须使用一致的 -Delimiter;需要遵循操作系统区域设置中的列表分隔符时,可以使用 -UseCulture,但不要同时指定 -Delimiter。结果只有一列时,应优先检查分隔符是否匹配。
PowerShell 7 中建议显式声明编码。通用系统交换可使用 -Encoding utf8;若文件主要交给依赖 BOM 识别编码的旧版 Windows 软件,可在导出时选择 utf8BOM。中文乱码通常不是 CSV 结构问题,而是读取编码与文件实际编码不一致。
参与比较和计算的字段应在导入后尽早转换。金额适合使用 decimal,固定格式日期适合使用 ParseExact,并明确区域性规则。源文件没有表头时可通过 -Header 提供属性名;如果原文件已有表头又指定 -Header,原表头会被当成普通数据。
验证导出结果时,应使用相同分隔符和编码重新执行 Import-Csv,检查记录数、属性名及关键字段。字段中包含分隔符、双引号或换行时,应让 CSV 命令负责引用和转义,不要手工拼接文本。