PowerShell 7/.NET 5环境加载CsvHelper无导出命令问题求助

核心原因说明 #

CsvHelper 是原生 .NET 类库，未封装 PowerShell Cmdlet，因此直接执行 Import-Module 加载 DLL 不会产生任何可导出的 PowerShell 命令，配置模块清单也无法导出命令是正常现象，无需排查清单配置问题，可直接调用库内的.NET类实现功能。 #

方案1：直接调用CsvHelper原生类（无需额外封装） #

适合开发人员调试、脚本自用场景，仅需依赖CsvHelper.dll单文件即可运行：

• 第一步：加载程序集，优先使用Add-Type命令：

  Add-Type -Path "你存放DLL的目录\CsvHelper.dll"
  

• 第二步：流式读取大CSV并适配datetime2类型的示例代码，内存占用低可支持GB级超大文件：

  # 引入所需命名空间
  using namespace System.IO
  using namespace CsvHelper
  using namespace CsvHelper.Configuration
  using namespace System.Data
  
  # 配置CSV解析规则
  $csvConfig = [CsvConfiguration]::new([Globalization.CultureInfo]::InvariantCulture)
  # 匹配SQL datetime2精度的日期格式，可按需调整
  $csvConfig.TypeConverterOptionsCache.GetOptions([datetime]).Formats = @("yyyy-MM-dd HH:mm:ss.fff")
  $csvConfig.Delimiter = "," # 按实际CSV分隔符修改
  
  # 流式打开CSV文件
  $streamReader = [StreamReader]::new("你的CSV文件路径\large_data.csv")
  $csvReader = [CsvReader]::new($streamReader, $csvConfig)
  
  # 初始化对接SqlBulkCopy的DataTable
  $dataTable = New-Object DataTable
  # 示例添加对应字段，可按需扩展列
  $dataTable.Columns.Add("id", [int]) | Out-Null
  $dataTable.Columns.Add("create_time", [datetime]) | Out-Null
  $dataTable.Columns.Add("content", [string]) | Out-Null
  
  # 逐行读取写入DataTable
  while ($csvReader.Read()) {
      $row = $dataTable.NewRow()
      $row["id"] = $csvReader.GetField([int], "id")
      $row["create_time"] = $csvReader.GetField([datetime], "create_time")
      $row["content"] = $csvReader.GetField([string], "content")
      $dataTable.Rows.Add($row)
  }
  
  # 此处可直接对接SqlBulkCopy执行入库，省略后续入库逻辑
  # 释放资源
  $csvReader.Dispose()
  $streamReader.Dispose()
  

方案2：封装为PowerShell模块（适配低操作能力用户部署） #

如果需要给普通用户提供开箱即用的PowerShell命令，可按以下结构封装，部署时仅需将整个目录拷贝到目标设备的PowerShell模块路径即可，无需联网安装任何依赖：

模块目录结构 #

CsvHelperWrapper
├── CsvHelper.dll
├── CsvHelperWrapper.psm1
└── CsvHelperWrapper.psd1

核心实现代码（CsvHelperWrapper.psm1） #

# 模块加载时自动加载依赖DLL
$dllPath = Join-Path $PSScriptRoot "CsvHelper.dll"
Add-Type -Path $dllPath | Out-Null

function Import-CsvToDataTable {
    param(
        [Parameter(Mandatory=$true)]
        [string]$FilePath,
        [string]$Delimiter = ",",
        [string[]]$DateTimeFormats = @("yyyy-MM-dd HH:mm:ss.fff")
    )
    # 此处将方案1的读取逻辑封装为函数，按业务需求返回DataTable或自定义对象即可
    # 具体实现逻辑可根据项目需求扩展
}

# 导出对外可用的命令
Export-ModuleMember -Function Import-CsvToDataTable

模块清单配置（CsvHelperWrapper.psd1） #

只需修改核心配置项即可：

• RootModule = 'CsvHelperWrapper.psm1'
• RequiredAssemblies = @('CsvHelper.dll')
• FunctionsToExport = @('Import-CsvToDataTable')
  其他项按常规PowerShell模块清单规则填写即可。部署完成后用户仅需执行Import-Module CsvHelperWrapper即可直接调用封装好的命令。

注意事项 #

• 确保使用的CsvHelper为适配.NET 5的编译版本，不要使用.NET Core 3.1或.NET 6编译版本，避免兼容性问题
• 处理超大型文件时必须使用流式读取，不要一次性加载全量内容到内存，可保持CsvHelper原生性能优势

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