将PowerShell的默认输出编码更改为UTF-8

Question

默认情况下，当您将命令的输出重定向到文件或通过管道将其导入PowerShell中的其他内容时，编码是UTF-16，这是不有用的。我想把它改成UTF-8。

可以通过将>foo.txt语法替换为out-file foo.txt-encoding utf8来逐个实现，但每次都要重复这样做会很尴尬。

在PowerShell中设置东西的持久方法是将它们放在\users\me\documents\windowsPowerShell\profile.ps1中；我已经验证了这个文件确实是在启动时执行的。

曾经说过，可以使用$psDefaultParameterValues=@{'out-file:encoding'='utf8'}设置输出编码，但我尝试过，没有效果。

https://blogs.msdn.microsoft.com/powershell/2006/12/11/outputencoding-to-the-reseconce/第一眼看上去好像应该是相关的，但随后它谈到了以ASCII编码的输出，而实际情况并非如此。

如何设置PowerShell使用UTF-8？

Answer 1

注意：以下内容适用于Windows PowerShell。
有关跨平台PowerShell Core(V6+)版，请参阅下一节。

>

在PSV5.1或更高版本（其中>和>实际上是out-file的别名）上，可以通过$PSDefaultParameterValues首选项变量为///out-file设置默认编码：

• $psDefaultParameterValues[“out-file:encoding”]=“utf8”

在PSV5.0或更低版本上，您不能更改>/>的编码，但在PSv3或更高版本上，上述技术可以用于对out-file的显式调用。
（$PSDefaultParameterValues首选项变量是在PSv3.0中引入的）。

在PSV3.0或更高版本上，如果要为所有支持
-encode参数（在PSV5.1+中包含和>)的cmdlet设置默认编码，请使用：

• $psDefaultParameterValues['*:Encoding']='utf8'

如果将此命令放在$profile中，则out-file和set-content等cmdlet默认情况下将使用UTF-8编码，但请注意，这使其成为会话全局设置，将影响未通过其-encode参数显式指定编码的所有命令/脚本。

同样，确保在您的脚本或模块中包含这样的命令，您希望以相同的方式运行，这样即使由另一个用户或不同的机器运行时，它们也确实表现相同；但是，要避免会话全局更改，请使用以下表单创建$PsDefaultParameterValues的本地副本：

• $psDefaultParameterValues=@{“*:Encoding”=“utf8”}

注意：从V5.1开始，PowerShell总是创建带有（伪）BOM的UTF-8文件，这只有在Windows世界中才是常见的--基于UNIX的实用程序不识别此BOM（参见底部）；有关创建无BOM的UTF-8文件的变通方法，请参阅本文。

有关许多Windows PowerShell标准cmdlet之间非常不一致的默认字符编码行为的摘要，请参阅底部部分。

自动$outputencoding变量不相关，只适用于PowerShell如何与外部程序通信（PowerShell向其发送字符串时使用的编码）--它与输出重定向运算符和PowerShell cmdlet用于保存到文件的编码无关。

PowerShell现在通过其PowerShell Core edition实现了跨平台化，其编码（合理地说）默认为无BOM的UTF-8，与类UNIX平台一致。

如果您在类似UNIX的平台上使用编辑器创建PowerShell脚本，现在甚至在Windows上使用跨平台编辑器（如Visual Studio代码和Sublime Text)，则生成的*.ps1文件通常不会有UTF-8伪BOM：

• 这在PowerShell内核上运行良好。
• 如果文件包含非ASCII字符，则在Windows PowerShell上可能会中断；如果您确实需要在脚本中使用非ASCII字符，请将它们保存为带BOM的UTF-8。
  如果没有BOM，Windows PowerShell(mis)将您的脚本解释为在遗留的“ANSI”代码页中编码（由Unicode前应用程序的系统区域设置确定；例如，美英系统上的Windows-1252）。

相反，具有UTF-8伪BOM的文件在类Unix平台上可能会有问题，因为它们会导致Unix实用程序（如cat、sed和awk)甚至一些编辑器（如gedit)传递伪BOM，即将其视为数据。

• 这可能并不总是一个问题，但绝对可能是一个问题，例如当您尝试将文件读入bash中的字符串时，例如，text=$(cat file)或text=$( -得到的变量将包含伪BOM作为前3个字节。

遗憾的是，Windows PowerShell中使用的默认字符编码非常不一致；跨平台PowerShell Core edition（如上一节所讨论的）已经很好地解决了这一问题。

注：

>

以下内容并不希望涵盖所有标准cmdlet。

set-content（如果文件尚不存在/为空，则add-content）使用ANSI编码（由活动系统区域设置的ANSI遗留代码页指定的编码，PowerShell将其称为default)。

export-csv确实创建了ASCII文件，如文档所示，但请参阅下面关于-append的注释。

export-pssession默认情况下使用BOM创建UTF-8文件。

new-item-type file-value当前创建无BOM（！）UTF-8。

send-mailmessage帮助主题还声称ASCII编码是默认值--我还没有亲自验证这个说法。

start-transcript总是使用BOM创建UTF-8文件，但请参阅下面关于-append的注释。

>/out-file-append不尝试匹配文件现有内容的编码。也就是说，它们盲目地应用默认编码，除非-encode另有指示，这不是>的选项（除非在PSV5.1+中通过$PsDefaultParameterValues间接地应用默认编码，如上图所示）。简而言之：您必须知道现有文件内容的编码，并使用相同的编码进行追加。

add-content是值得称赞的例外：在没有显式-encode参数的情况下，它检测现有编码并自动将其应用到新内容。谢谢，JS2010。请注意，在Windows PowerShell中，这意味着如果现有内容没有BOM，则应用ANSI编码，而在PowerShell Core中则是UTF-8。

out-file-append/>和add-content之间的这种不一致性也会影响PowerShell Core，本文将在GitHub问题中讨论。

export-csv-append与现有编码部分匹配：如果现有文件的编码是ASCII/UTF-8/ANSI中的任何一种，则它盲目地追加UTF-8，但正确地匹配UTF-16LE和UTF-16BE。
换一种说法：在没有BOM的情况下，export-csv-append假定UTF-8IS，而add-content假定ANSI。

start-transcript-append与现有编码部分匹配：它与BOM的编码正确匹配，但如果没有ASCII编码，则默认为可能有损的ASCII编码。

读取（即在没有BOM时使用的编码）的cmdlet：

Get-Content和Import-PowerShellDataFile默认为ANSI(default)，这与Set-Content一致。
ANSI也是PowerShell引擎本身从文件读取源代码时默认为的。

相比之下，import-csv、import-clixml和select-string在没有BOM的情况下假定为UTF-8。