1. 临时修改终端编码快速救火方案第一次在Windows上调试Electron项目时看到控制台输出的中文变成一堆问号和乱码我差点以为自己的代码被外星人劫持了。后来才发现这是Windows终端默认使用GBK编码代码页936而现代开发环境普遍采用UTF-8编码代码页65001导致的经典冲突。最快速的解决方案是直接在终端输入chcp 65001这个命令就像给终端戴了一副编码眼镜让它能正确识别UTF-8字符。我实测过执行后立即就能看到正常的中文输出。不过要注意的是这个修改只在当前终端会话有效关闭窗口后下次打开又会恢复成GBK编码。有个细节容易被忽略如果在VSCode的集成终端里执行这个命令需要确保终端类型是cmd而不是PowerShell。因为PowerShell使用不同的编码切换机制可以用[Console]::OutputEncoding [System.Text.Encoding]::UTF8来切换。2. 永久修改终端编码一劳永逸的两种方案2.1 系统区域设置修改法在Windows 10 1903及以上版本中微软终于提供了全局UTF-8支持选项按WinS搜索区域设置进入管理→更改系统区域设置勾选使用Unicode UTF-8提供全球语言支持重启电脑这个方案我在三台不同配置的Windows电脑上都测试过效果非常稳定。不过要注意两点这是系统级修改会影响所有应用程序某些老旧程序可能会出现兼容性问题2.2 注册表修改法对于不能修改系统区域设置的情况可以通过注册表单独修改cmd终端的默认编码按WinR输入regedit打开注册表编辑器导航到HKEY_CURRENT_USER\Console\%SystemRoot%_system32_cmd.exe新建DWORD (32位)值命名为CodePage将值设置为十进制65001我建议在修改前先导出这个注册表项作为备份。修改后新打开的cmd窗口都会默认使用UTF-8编码但对已经打开的终端无效。3. 项目启动脚本集成方案作为团队协作项目我们不能要求每个成员都修改系统设置。这时可以在package.json中直接集成编码切换命令scripts: { start: chcp 65001 electron ., dev: chcp 65001 electronmon . }这个方案有个实际开发中常见的问题当使用npm start启动时Windows会创建新的cmd进程来执行脚本编码设置只影响子进程。解决方法是在命令前添加cmd /cstart: cmd /c chcp 65001 electron .4. 使用concurrently工具的优雅方案对于更复杂的启动场景比如需要同时运行多个命令时我推荐使用concurrently工具。先安装npm install -D concurrently然后修改package.jsonscripts: { start: concurrently \chcp 65001\ \electron .\ }concurrently的优点是能保持终端窗口干净而且可以扩展更多并行任务。我在实际项目中发现当需要同时启动后端API服务时这个方案特别有用start: concurrently \chcp 65001\ \electron .\ \node server.js\5. VSCode开发环境专项配置VSCode的终端乱码问题需要单独处理因为它的集成终端有自己的配置体系。推荐以下两种方法5.1 修改settings.json{ terminal.integrated.profiles.windows: { Command Prompt: { path: cmd.exe, args: [/k, chcp 65001] } } }5.2 更彻底的解决方案在项目根目录创建.vscode/settings.json{ terminal.integrated.defaultProfile.windows: Command Prompt, terminal.integrated.shellArgs.windows: [/k, chcp 65001], files.encoding: utf8, files.autoGuessEncoding: true }这个配置我用了两年多从没出现过乱码问题。特别是files.autoGuessEncoding对于接手历史项目特别有用能自动识别文件编码。6. 其他关键注意事项6.1 文件保存编码检查即使终端编码正确如果源代码文件本身不是UTF-8保存也会出问题。建议在所有编辑器中显式设置文件编码为UTF-8确保没有BOM头Unix风格换行符6.2 Electron主进程配置在创建BrowserWindow时建议显式设置webPreferencesnew BrowserWindow({ webPreferences: { nodeIntegration: true, contextIsolation: false, webSecurity: false } })6.3 第三方模块的特殊情况有些Node.js原生模块比如某些数据库驱动会依赖系统编码。遇到这种情况时除了设置终端编码外可能还需要在代码中显式转换const iconv require(iconv-lite) const result iconv.decode(buffer, gbk)我在处理一个银行项目对接时就遇到过第三方接口返回GBK编码的情况。最终是通过在axios拦截器中集成iconv-lite解决的。