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

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

问题描述

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

bash 复制代码
$ python -c "print('测试中文输出')"
�����˺Ž�����������

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

原因分析

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

复制代码
Python stdout → 终端(Claude Code Bash工具) → 显示
环节 编码 说明
Windows 系统默认 GBK (CP936) 中文 Windows 的系统 locale 编码
Python stdout 跟随系统 默认使用 locale.getpreferredencoding(),即 GBK
Claude Code Bash 工具 UTF-8 期望接收 UTF-8 编码的字节流

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

简单来说:

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

解决方案

方案对比

方案 原理 优点 缺点
PYTHONIOENCODING=utf-8 环境变量 强制 Python stdout 使用 UTF-8 一劳永逸,不侵入代码 需要重启终端生效
每次命令前加 chcp 65001 切换控制台代码页 无需改环境变量 每次都要加,且对 Git Bash 不一定生效
代码内 sys.stdout 重包装 Python 内部强制编码 精确控制 侵入性强,每个脚本都要改

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

具体操作

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

打开 PowerShell(普通权限即可),执行:

powershell 复制代码
New-ItemProperty -Path 'HKCU:\Environment' -Name 'PYTHONIOENCODING' -Value 'utf-8' -PropertyType String -Force

验证是否写入成功:

powershell 复制代码
[System.Environment]::GetEnvironmentVariable('PYTHONIOENCODING', 'User')
# 输出: utf-8

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

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

第二步:重启终端/应用

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

第三步:验证
bash 复制代码
$ 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 中添加:

    bash 复制代码
    export PYTHONIOENCODING=utf-8

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

总结

项目 内容
问题 Windows 下 Bash 调用 Python 输出中文乱码
根因 Python 默认 GBK 编码 vs 终端 UTF-8 编码不匹配
解决 注册表设置 PYTHONIOENCODING=utf-8,重启生效
验证 python -c "print('你好世界 ✅')" 正常输出

如果这篇文章对你有帮助,欢迎点赞 👍 收藏 ⭐ 关注,后续会持续分享更多开发中遇到的问题和解决方案。

相关推荐
TomEval9 小时前
【测AI】第26篇:线上模型监控与告警体系 — 测试不是终点
人工智能·python·功能测试·ai
prince_zxill9 小时前
PEP 751 pylock.toml 实测:pip 26.3 装 6 个包版本全钉死,但 [web] 选不中任何东西
python·pip·依赖管理·pep 751
Thanks_ks11 小时前
Python 的垃圾回收——引用计数撑起日常,分代回收收拾残局
python·内存管理·垃圾回收·循环引用·引用计数·gc 模块·weakref
CyrusYiVPP11 小时前
实测 uv 0.13.7:同一套包,pip 装 94 秒,它只用 19 秒
人工智能·python
yiangL_11 小时前
Python 学习笔记:递归、turtle绘图、字符串与函数
笔记·python·学习
lula88813 小时前
PVC-U、PVC-C、PVC-O 差一个字母,差的是三种增强路线
python
数字工作台14 小时前
给 LangGraph 加一道可审计记忆:替换默认 Checkpointer,实现防篡改 + 崩溃不丢数据
python·agent
DKPT14 小时前
Python 的 Web 框架:选型选错的人,都踩了同一个坑
python
2401_8685347815 小时前
逻辑网络设计
网络·python
2601_9679791215 小时前
python如何组织文件?python文件操作全介绍!
python·文件操作·压缩文件·遍历文件夹·shutil模块