Thay đổi mã hóa đầu ra mặc định của PowerShell thành UTF-8


105

Theo mặc định, khi bạn chuyển hướng đầu ra của một lệnh tới một tệp hoặc chuyển nó vào một thứ khác trong PowerShell, mã hóa là UTF-16, điều này không hữu ích. Tôi đang tìm cách đổi nó thành UTF-8.

Nó có thể được thực hiện trong từng trường hợp cụ thể bằng cách thay thế >foo.txtcú pháp bằng | out-file foo.txt -encoding utf8nhưng điều này rất khó xử khi phải lặp lại mỗi lần.

Cách bền bỉ để thiết lập mọi thứ trong PowerShell là đặt chúng vào \Users\me\Documents\WindowsPowerShell\profile.ps1; Tôi đã xác minh rằng tệp này thực sự được thực thi khi khởi động.

Người ta nói rằng có thể đặt mã hóa đầu ra $PSDefaultParameterValues = @{'Out-File:Encoding' = 'utf8'}nhưng tôi đã thử điều này và nó không có tác dụng.

https://blogs.msdn.microsoft.com/powershell/2006/12/11/outputencoding-to-the-rescue/ nói về $OutputEncodingcái nhìn thoạt nhìn như thể nó phải có liên quan, nhưng sau đó nó nói về đầu ra được mã hóa trong ASCII, đó không phải là những gì đang thực sự xảy ra.

Làm cách nào để bạn đặt PowerShell sử dụng UTF-8?

Câu trả lời:


162

Lưu ý: Điều sau áp dụng cho Windows PowerShell .
Xem phần tiếp theo về ấn bản PowerShell Core (v6 +) đa nền tảng .

  • Trên PSv5.1 trở lên , ở đâu >và thực sự >>là bí danh của Out-File, bạn có thể đặt mã hóa mặc định cho >/ >>/ Out-Filethông qua $PSDefaultParameterValuesbiến tùy chọn :

    • $PSDefaultParameterValues['Out-File:Encoding'] = 'utf8'
  • Trên PSv5.0 hoặc bên dưới , bạn không thể thay đổi mã hóa cho >/>> , nhưng, trên PSv3 hoặc cao hơn , các kỹ thuật nói trên làm việc cho các cuộc gọi rõ ràng đểOut-File .
    (Biến $PSDefaultParameterValuestùy chọn đã được giới thiệu trong PSv3.0).

  • Trên PSv3.0 trở lên , nếu bạn muốn đặt mã hóa mặc định cho tất cả các lệnh ghép ngắn hỗ trợ
    một -Encodingtham số
    (trong PSv5.1 + bao gồm >>>), hãy sử dụng:

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

Nếu bạn đặt lệnh này trong của bạn$PROFILE , các lệnh ghép ngắn chẳng hạn như Out-FileSet-Content sẽ sử dụng mã hóa UTF-8 theo mặc định, nhưng lưu ý rằng điều này làm cho nó trở thành cài đặt toàn cầu phiên sẽ ảnh hưởng đến tất cả các lệnh / tập lệnh không chỉ định rõ ràng một mã hóa.

Tương tự, hãy đảm bảo bao gồm các lệnh như vậy trong các tập lệnh hoặc mô-đun mà bạn muốn hoạt động theo cùng một cách , để chúng thực sự hoạt động giống nhau ngay cả khi được chạy bởi một người dùng khác hoặc một máy khác.

Lưu ý : ** PowerShell, kể từ v5.1, luôn tạo tệp UTF-8 _ với BOM (giả) _ ** , điều này thường chỉ xảy ra trong thế giới Windows - Các tiện ích dựa trên Unix không nhận dạng BOM này (xem phần dưới); xem bài đăng này để biết các giải pháp thay thế tạo tệp UTF-8 không có BOM.

Để biết tóm tắt về hành vi mã hóa ký tự mặc định hoàn toàn không nhất quán trên nhiều lệnh ghép ngắn chuẩn của Windows PowerShell , hãy xem phần dưới cùng.


Tự động $OutputEncodingbiến là không liên quan , và chỉ áp dụng cho cách PowerShell giao tiếp với chương trình bên ngoài (những gì mã hóa sử dụng PowerShell khi gửi chuỗi cho họ) - nó không có gì để làm với mã hóa mà các nhà khai thác chuyển hướng đầu ra và PowerShell cmdlets sử dụng để lưu vào tập tin.


Đọc tùy chọn: Quan điểm đa nền tảng: PowerShell Core :

PowerShell hiện là nền tảng đa nền tảng , thông qua phiên bản PowerShell Core , có mã hóa - hợp lý - được mặc định thành UTF-8 không có BOM , phù hợp với các nền tảng giống Unix.

  • Điều này có nghĩa là các tệp mã nguồn không có BOM được giả định là UTF-8 và sử dụng >/ Out-File/ Set-Contentmặc định là UTF-8 không có BOM ; Việc sử dụng utf8 -Encodingđối số một cách rõ ràng cũng tạo ra UTF-8 không có BOM, nhưng bạn có thể chọn tạo các tệp BOM giả với utf8bomgiá trị.

  • Nếu bạn tạo tập lệnh PowerShell bằng trình chỉnh sửa trên nền tảng giống Unix và ngày nay ngay cả trên Windows với trình chỉnh sửa đa nền tảng như Visual Studio Code và Sublime Text, *.ps1tệp kết quả thường sẽ không có BOM giả UTF-8:

    • Điều này hoạt động tốt trên PowerShell Core .
    • Nó có thể bị hỏng trên Windows PowerShell , nếu tệp chứa các ký tự không phải ASCII; nếu bạn cần sử dụng các ký tự không phải ASCII trong tập lệnh của mình, hãy lưu chúng dưới dạng UTF-8 với BOM .
      Nếu không có BOM, Windows PowerShell (sai) diễn giải tập lệnh của bạn được mã hóa theo kiểu mã "ANSI" kế thừa (được xác định bởi ngôn ngữ hệ thống cho các ứng dụng trước Unicode; ví dụ: Windows-1252 trên hệ thống tiếng Anh-Mỹ).
  • Ngược lại, các file mà làm có UTF-8 pseudo-BOM thể được vấn đề trên Unix-như nền tảng, vì chúng gây ra các tiện ích Unix như cat, sedawk- và thậm chí một số biên tập viên như gedit- để vượt qua pseudo-HĐQT thông qua , tức là, để coi nó như là dữ liệu .

    • Điều này có thể không phải lúc nào cũng là một vấn đề, nhưng chắc chắn có thể xảy ra, chẳng hạn như khi bạn cố gắng đọc một tệp thành một chuỗi bashvới, chẳng hạn, text=$(cat file)hoặc text=$(<file)- biến kết quả sẽ chứa BOM giả dưới dạng 3 byte đầu tiên.

Hành vi mã hóa mặc định không nhất quán trong Windows PowerShell :

Rất tiếc, mã hóa ký tự mặc định được sử dụng trong Windows PowerShell hoàn toàn không nhất quán; phiên bản PowerShell Core đa nền tảng , như đã thảo luận trong phần trước, đã kết thúc tốt đẹp vấn đề này.

Ghi chú:

  • Phần sau không bao gồm tất cả các lệnh ghép ngắn chuẩn.

  • Các tên lệnh ghép ngắn trên Google để tìm các chủ đề trợ giúp của chúng hiện hiển thị cho bạn phiên bản PowerShell Core của các chủ đề theo mặc định; sử dụng danh sách phiên bản thả xuống phía trên danh sách chủ đề ở bên trái để chuyển sang phiên bản Windows PowerShell .

  • Kể từ khi viết bài này, tài liệu thường tuyên bố không chính xác rằng ASCII là mã hóa mặc định trong Windows PowerShell - hãy xem sự cố tài liệu GitHub này .


Cmdlets viết :

Out-File>/ >>tạo "Unicode" - UTF-16LE - tệp theo mặc định - trong đó mỗi ký tự trong phạm vi ASCII (quá) được biểu thị bằng 2 byte - điều này đáng chú ý khác với Set-Content/ Add-Content(xem điểm tiếp theo); New-ModuleManifestExport-CliXmlcũng tạo tệp UTF-16LE.

Set-Content(và Add-Contentnếu tệp chưa tồn tại / trống) sử dụng mã hóa ANSI (mã hóa được chỉ định bởi trang mã kế thừa ANSI của ngôn ngữ hệ thống đang hoạt động, mà PowerShell gọi Default).

Export-Csvthực sự tạo ra các tệp ASCII, như được ghi lại, nhưng hãy xem các ghi chú -Appendbên dưới.

Export-PSSession tạo tệp UTF-8 với BOM theo mặc định.

New-Item -Type File -Value hiện đang tạo BOM-less (!) UTF-8.

Các Send-MailMessagechủ đề trợ giúp cũng tuyên bố rằng mã hóa ASCII là mặc định - Tôi đã không đích thân xác nhận rằng tuyên bố.

Start-Transcript luôn tạo tệp UTF-8 với BOM, nhưng hãy xem ghi chú -Appendbên dưới.

Lệnh Re nối vào một tệp hiện có:

>>/ Out-File -AppendLàm không cố gắng để phù hợp với mã hóa của một tập tin nội dung hiện có . Có nghĩa là, họ áp dụng mã hóa mặc định của mình một cách mù quáng, trừ khi được hướng dẫn khác với -Encoding, không phải là một tùy chọn với >>(ngoại trừ gián tiếp trong PSv5.1 +, thông qua $PSDefaultParameterValues, như được hiển thị ở trên). Tóm lại: bạn phải biết mã hóa nội dung của tệp hiện có và nối thêm bằng cách sử dụng cùng mã hóa đó.

Add-Contentlà ngoại lệ đáng khen ngợi: trong trường hợp không có -Encodingđối số rõ ràng , nó sẽ phát hiện mã hóa hiện có và tự động áp dụng nó cho nội dung mới. Cảm ơn, js2010 . Lưu ý rằng trong Windows PowerShell, điều này có nghĩa là mã hóa ANSI được áp dụng nếu nội dung hiện có không có BOM, trong khi đó là UTF-8 trong PowerShell Core.

Sự mâu thuẫn này giữa Out-File -Append/ >>Add-Content, cũng ảnh hưởng đến PowerShell Core , được thảo luận trong vấn đề GitHub này .

Export-Csv -Append khớp một phần với mã hóa hiện có: nó nối UTF-8 một cách mù quáng nếu mã hóa của tệp hiện có là bất kỳ ASCII / UTF-8 / ANSI nào, nhưng khớp chính xác UTF-16LE và UTF-16BE.
Nói cách khác: trong trường hợp không có BOM, Export-Csv -Appendgiả sử UTF-8 là, trong khi Add-Contentgiả định ANSI.

Start-Transcript -Append khớp một phần với mã hóa hiện có: Nó khớp chính xác các mã hóa với BOM , nhưng mặc định là mã hóa ASCII có khả năng mất dữ liệu nếu không có.


Cmdlets đọc (nghĩa là mã hóa được sử dụng trong trường hợp không có BOM ):

Get-ContentImport-PowerShellDataFilemặc định là ANSI ( Default), phù hợp với Set-Content.
ANSI cũng là thứ mà công cụ PowerShell tự mặc định khi nó đọc mã nguồn từ các tệp.

Ngược lại, Import-Csv, Import-CliXmlSelect-Stringgiả định UTF-8 trong sự vắng mặt của một BOM.


Bạn có thể giải thích cách >/ >>trở thành bí danh hiệu quả Out-Filetrong 5.1 không?
Maximilian Burszley

@ TheIncorrigible1: Có thể PetSerAl đã chỉ cho tôi, nhưng tôi không nhớ ở đâu và như thế nào. Windows PowerShell là nguồn đóng, nhưng vì mối quan hệ gần như bí danh cũng áp dụng cho PowerShell Core, bạn sẽ có thể tìm thấy nó trong mã nguồn của sau này.
mklement0

2
Tôi không đồng ý, @EliaWeiss, nhưng đó là Windows PowerShell cụ thể và cuối cùng họ đã làm được nó ngay trong PowerShell Core .
mklement0

2
@Marc: VS Code và các trình chỉnh sửa đa nền tảng hiện đại khác được khen ngợi mặc định thành UTF-8, tuy nhiên, điều này có nghĩa là chúng sẽ hiểu sai các tệp được mã hóa ANSI. Notepad sử dụng heuristics để đoán mã hóa. Vấn đề là đó chỉ là phỏng đoán , vì bất kỳ tệp nào được mã hóa UTF-8 cũng là tệp được mã hóa ANSI hợp lệ về mặt kỹ thuật (nhưng không phải ngược lại). Sẽ thật tuyệt nếu mọi thứ trên Windows được mặc định thành UTF-8 trong trường hợp không có BOM như cách các nền tảng giống Unix vẫn làm, nhưng không phải vậy, đáng chú ý là không phải trong Windows PowerShell, mặc dù may mắn thay, bây giờ là trường hợp trong PowerShell Core.
mklement0

2
Để xem giá trị hiện tại của bạn nếu một số, chỉ cần nhập$PSDefaultParameterValues
Sandburg

3

Nói ngắn gọn, hãy sử dụng:

write-output "your text" | out-file -append -encoding utf8 "filename"
Khi sử dụng trang web của chúng tôi, bạn xác nhận rằng bạn đã đọc và hiểu Chính sách cookieChính sách bảo mật của chúng tôi.
Licensed under cc by-sa 3.0 with attribution required.