Windows Powershell | 解決 Git 中文亂碼

最近用 Windows 10 工作的時間比較多，因為被關在家咩。

自從上次安裝 WSL 時使用了 PowerShell 後，發現它可在 Windows 上下些常用的 Linux 的指令、基本可以滿足我的基本需求後，我幾乎放棄了 Windows 的命令提示字元。

但它有個麻煩的問題…雖然開發過程中少有用到中文，但像是我在寫網誌的時候就會用到，此時就會發現中文變成了亂碼…

不是我要說…，但 diff 長這樣是要我通靈喔！

問題確認

先確認下問題，當我建立一份名為 測試.txt 的新檔案後，嘗試下達 git status 與 git diff 會發現，涉及中文的部分都出現了亂碼。

看起來應該是編碼問題？觀察下一個字元對應到了三個編碼，感覺像是 UTF-8 的儲存格式，但直接沒有轉換顯示，直接就用印出來了？

不過，我如果用 cat 來看內文的話，一切正常：

推測兩個可能原因：

終端機的編碼設定
git 的問題

第二點我不太確定，因為我在 Linux 上時不需要這種設定，可能需要更多的嘗試來確認問題。所以我決定先來調整終端機的編碼設定，如果失敗了，再來研究 git 這邊。

預設使用 UTF-8 編碼

根據 Stackoverflow 上所提到的，先來確認 [console]::OutputEncoding、 [console]::InputEncoding、 $OutputEncoding 這三個變數：

可以發現 [console]::OutputEncoding、[console]::InputEncoding 兩個變數的顯示是使用 Big5：

不過 $OutputEncoding 這個變數結果卻呈現 UTF-8。兩個跟 Output 相關的編碼，一個呈現 Big5、一個用 UTF-8，所以現在是歸誰管？

最後還是決定先繼續往下做，先把所有編碼都改成 UTF-8 再說。所以接下來先來查查，個人設定檔的配置路徑，這個值可以藉由 $PROFILE 變數得知：

根據所查到的路徑前往修改檔案，如果 Microsoft.PowerShell_profile.ps1 檔案不存在就直接建立一個，並添增下列內容：

$OutputEncoding = [console]::InputEncoding = [console]::OutputEncoding = [Text.UTF8Encoding]::UTF8

完成後啟動一個新的視窗，理論上預設編碼就都會呈現 UTF-8 了。

題外話，那天跟同事討論了踩坑排行榜，雖然我不像前面兩位同事是踩坑專業戶，該踩得、不該踩得坑全都一個不落；但該掉的坑我似乎也沒有幸運躲過，你看這不就來一個錯誤訊息了嗎？

在我修改完個人設定檔後，重啟 PowerShell 時跳出了下列錯誤訊息：

查了下原因，發現是因為是 Windows 執行安全性設置所導致的，在 PowerShell 預設的執行原則是 Restricted，也就是限制原則，它阻止所有 script 的運行，包含剛剛的 PowerShell 配置文件 (.ps1)。

所以需要藉由 Set-ExecutionPolicy 指令重新調整執行原則，相關指令設置說明的說明可以看這裡。這邊我們把執行原則上調到 RemoteSigned，它可以不需要簽署就執行在本機所撰寫的 script，但若是從下載的 script 就必須經過簽署後才可執行。

喔，對了 Set-ExecutionPolicy 這條指令的執行，必須具備系統管理員身份。所以我又重起了一個以系統管理員身份執行的 PowerShell，並按 A 同意變更執行原則：

修改完成後，再次看看 diff 結果，結果仍然是亂碼

不過 cat 指令的結果依舊正常，我還疑這部分應該是 $OutputEncoding 所控制的，就是我系統一開始就呈現 UTF-8 的那個變數。

設定 git encoding

查了下，其實我的中心思想沒有錯，設定好 UTF-8 編碼即可。

不過好像 Git for Windows 內建的 git.exe 工具，是走 UNIX-like 作業系統環境下，所以非英語系語言的文字要另外設定。這點 git 可以直接透過指令將編碼調整成 UTF-8

# encoding of status output 
$ git config --global core.quotepath false

# GUI encoding
$ git config --global gui.encoding utf-8

# encoding of commit messages
$ git config --global i18n.commit.encoding utf-8 

# encoding of log outputs
$ git config --global i18n.logoutputencoding utf-8 

這時看看 status，可以正常顯示檔名了：

但是涉及 log、 diff 跟使用者名稱的中文還是亂碼：

設定 `LESSCHARSET` 環境變數

這時需要再設定 LESSCHARSET 環境變數，用於設定 character set：

# Git uses the less pager by default. This command is to convert the encoding of less commands to UTF-8.
$ export LESSCHARSET=utf-8 

不過 export 的設法僅顯於目前這個 process，一旦重啟視窗設定就會跳掉，所以如果要永久生效的話，還是要取改剛剛的 Microsoft.PowerShell_profile.ps1。直接在最後加上

$env:LESSCHARSET='utf-8'

最後再試試看指令，終於能正常呈現了：

是說，如果是設定 git 指令可以解掉大半，那麼在命令提示字元上效果應該也是可行的？果不其然，在命令提示字元上，status 已經正常顯示，而 log、diff 跟使用者名稱則還是亂碼。因此這個時候，僅需設定命令提示字元上的 LESSCHARSET 即可。

命令提示字元的變數的話，就要去改登錄編輯程式，這可以直接從搜尋欄輸入 regedit 叫出。然後依序尋找 HKEY_LOCAL_MACHINE > Software > Microsoft > Command Processo，並新增變數：

設定 `LC_ALL`

如果不設定 LESSCHARSET 環境變數，另一個方法是改設定 LC_ALL 語言環境變數，得益於 git 是 UNIX-like 的，所以這方法也可行。

$ SET LC_ALL=C.UTF-8

如果要每次啟動都生效的話，就改用：

$ SETX LC_ALL C.UTF-8 

完成後，就可以看到顯靈結果啦！再也不用通靈看 diff 了：

參考資料

Michelle Chen (2021-12-20)。[Windows] 程式設計教學：使用 PowerShell。檢自開源技術教學網 (2022-06-24)。
協同撰寫。PowerShell。檢自維基百科 (2022-06-24)。
Neil Tsai (2020-02-21)。Command Prompt / Windows Powershell 預設使用 UTF-8 編碼 (Windows 10)。檢自 Thinkin Markdown (2022-06-24)。
Ray (2021-01-06)。解決 Windows 上輸入指令出現「因為這個系統上已停用指令碼執行，所以無法載入…」的問題。檢自是 Ray 不是 Array (2022-06-24)。
sysin (2021-11-21)。Windows 10 环境变量：通过 CMD 和 PowerShell 写入环境变量。檢自 SYStem INside (2022-06-24)。
(2021-11-21)。Setting the Encoding on Windows。檢自 HUAWEI CLOUD (2022-06-24)。

更新紀錄

最後更新日期：2022-07-10

2022-07-10 發布
2022-07-10 完稿
2022-06-24 起稿