node-winreg 中文亂碼問題分析與解決詳情 - 前端,node.js,registry 點墨動態日志

問題描述

在使用 node-winreg 庫操作 Windows 註冊表時，發現存取中文字符存在亂碼問題：

寫入註冊表的中文內容顯示正常
從註冊表讀取中文內容時出現亂碼

winreg的版本如下:

問題根源分析

通過源碼分析，發現問題出現在字符編碼的處理環節：

寫入過程：node-winreg 底層使用 spawn 執行 reg 命令，在 Windows 命令行環境中默認使用 GBK 編碼，因此中文內容以 GBK 編碼格式正確寫入註冊表
讀取過程：讀取註冊表時，獲取到的 Buffer 數據使用 buffer.toString() 方法進行解碼，該方法默認使用 UTF-8 編碼
編碼不一致：GBK 編碼寫入，UTF-8 編碼讀取，導致中文字符解碼錯誤，產生亂碼

解決方案

方案一：修改命令行編碼（推薦）

在 spawn 執行 reg 命令前，先執行 chcp 65001 命令將控制枱編碼設置為 UTF-8：

// 修改前執行的命令
reg query "HKEY_CURRENT_USER\Software" /f "中文" /k

// 修改後執行的命令  
chcp 65001 && reg query "HKEY_CURRENT_USER\Software" /f "中文" /k

優點：

編碼統一為 UTF-8，符合現代開發標準
一勞永逸解決所有字符編碼問題

方案二：使用 iconv-lite 解碼

安裝 iconv-lite 庫，在解碼時明確指定使用 GBK 編碼：

const iconv = require('iconv-lite');

// 修改前
const result = buffer.toString();

// 修改後
const result = iconv.decode(buffer, 'gbk');

優點：

精確控制解碼過程
不依賴系統環境設置

具體實現

兩種方案都需要修改 node-winreg 的源碼：

方案一實現

在創建子進程執行 reg 命令的代碼處，修改命令拼接邏輯：

// 在 lib/registry.js 中找到 getRegExePath 方法
function getRegExePath() {
    if (process.platform === 'win32') {
        return path.join(process.env.windir, 'system32', 'reg.exe');
    } else {
        return "REG";
    }
}

修改為

function getRegExePath() {
    if (process.platform === 'win32') {
        return "chcp 65001 &&" + path.join(process.env.windir, 'system32', 'reg.exe');
    } else {
        return "chcp 65001 && REG";
    }
}