Windows下Bash调用Python输出中文乱码问题的解决方案

问题描述

在 Windows 11 环境下，通过 Claude Code 的 Bash 工具执行 Python 命令时，输出的中文字符全部显示为乱码：

$ python -c "print('测试中文输出')"
�����˺Ž�����������

英文和符号正常，唯独中文变成了一堆问号和方块。

原因分析

这是一个经典的 编码不匹配 问题，涉及三层编码链路：

Python stdout → 终端(Claude Code Bash工具) → 显示

问题根因：Python 用 GBK 编码输出中文，但 Claude Code 的终端按 UTF-8 解读这些字节，编码不匹配导致乱码。

简单来说：

GBK 编码的「你」是 \xc4\xe3，UTF-8 解读这俩字节变成了 ��。

解决方案

方案对比

推荐方案：设置 PYTHONIOENCODING=utf-8 环境变量。

具体操作

第一步：通过注册表永久设置环境变量

打开 PowerShell（普通权限即可），执行：

New-ItemProperty -Path 'HKCU:\Environment' -Name 'PYTHONIOENCODING' -Value 'utf-8' -PropertyType String -Force

验证是否写入成功：

[System.Environment]::GetEnvironmentVariable('PYTHONIOENCODING', 'User')
# 输出: utf-8

为什么用注册表而不是 PowerShell 的 SetEnvironmentVariable？

实测发现通过 [System.Environment]::SetEnvironmentVariable() 设置的用户级环境变量，在某些环境下（如 Claude Code 的 Bash 工具）不会被新进程继承。直接写注册表 HKCU:\Environment 更可靠。

第二步：重启终端/应用

环境变量在进程启动时继承，必须重启当前终端或 Claude Code，新值才会生效。

第三步：验证

$ python -c "print('你好世界 ✅')"
你好世界 ✅

中文正常显示，乱码问题解决。

注意事项

1. 仅对新进程生效：已打开的终端窗口不会自动刷新环境变量，需要关闭重开。
2. 影响范围：PYTHONIOENCODING=utf-8 会影响所有 Python 进程的 stdout/stderr 编码。对于大多数场景这是期望行为，但如果你有脚本依赖 GBK 输出（比如写文件给老系统读），需要注意。
3. Git Bash / MSYS2 的特殊性：Claude Code 在 Windows 上使用的 Bash 工具底层是 Git Bash（MSYS2），它对 Windows 环境变量的继承行为有时不太一致。如果设置环境变量后仍不生效，可以尝试在 ~/.bashrc 中添加：

export PYTHONIOENCODING=utf-8

但这只对交互式 Shell 生效，Claude Code 的 Bash 工具跑的是非交互模式，所以不一定有用。注册表方式更可靠。

总结

到此这篇关于Windows下Bash调用Python输出中文乱码问题的解决方案的文章就介绍到这了,更多相关Windows Bash调用Python输出中文乱码内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

最新评论