问题：PyCharm设置控制台打印编码为UTF-8的方法？

Question

在使用 PyCharm 进行 Python 开发时，经常会遇到控制台输出中文字符出现乱码的问题，这是由于默认编码格式不为 UTF-8 所致。那么，如何正确设置 PyCharm 控制台的打印编码为 UTF-8？该问题涉及 PyCharm 的运行配置、Python 脚本编码声明以及操作系统控制台的默认编码设置等多个方面。本文将围绕这一常见技术问题，深入解析在不同操作系统（如 Windows、macOS、Linux）下如何配置 PyCharm 以确保控制台输出使用 UTF-8 编码，从而有效解决中文乱码问题。

Answer 1

PyCharm 控制台中文乱码问题深度解析与解决方案

1. 问题背景与现象描述

在使用 PyCharm 进行 Python 开发时，控制台输出中文字符出现乱码是一个常见问题。典型表现为：

• 控制台输出显示为“????”或“”等符号
• 日志文件中中文字符无法正常显示
• 跨平台开发时问题表现不一致

2. 乱码成因分析

乱码的本质是字符编码不一致，主要涉及以下几个层面：

层级	可能影响编码的配置点
Python 脚本	文件编码声明（如 # -*- coding: utf-8 -*-）
PyCharm IDE	项目编码设置、运行配置中的编码参数
操作系统控制台	Windows CMD/Powershell、Linux Terminal、macOS Terminal 的默认编码

3. 解决方案路径图

解决乱码问题的路径如下流程图所示：

graph TD
            A[开始] --> B{操作系统类型?}
            B -->|Windows| C[设置控制台代码页为65001]
            B -->|macOS/Linux| D[确认终端默认编码为UTF-8]
            C --> E[配置PyCharm运行配置编码]
            D --> E
            E --> F[设置Python脚本编码声明]
            F --> G[验证输出结果]
            G --> H{是否仍有乱码?}
            H -->|是| I[检查环境变量LANG/LC_ALL]
            H -->|否| J[问题解决]
            I --> G

4. 具体配置步骤

4.1 设置操作系统控制台编码

• Windows：
  • 临时修改：在 CMD 中执行 chcp 65001 切换到 UTF-8 模式
  • 永久修改：注册表中修改 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\CodePage\ACP 为 65001
• macOS/Linux：
  • 终端默认编码一般为 UTF-8，可通过 locale 命令查看
  • 若非 UTF-8，可通过修改 /etc/default/locale 或用户环境变量设置 LANG=en_US.UTF-8

4.2 配置 PyCharm 的编码设置

进入 PyCharm 设置（Settings）路径如下：

1. File → Settings (Windows/Linux) 或 PyCharm → Preferences (macOS)
2. Editor → File Encodings
3. 设置以下三项为 UTF-8：
   • Global Encoding
   • Project Encoding
   • Default encoding for properties files

4.3 配置运行配置的环境参数

在运行配置中添加以下参数，确保子进程使用 UTF-8 编码：

-X utf8

或者在运行配置的 Environment variables 中添加：

PYTHONIOENCODING=utf-8

4.4 Python 脚本文件编码声明

在每个 Python 脚本头部添加编码声明（适用于 Python 2.x 和部分旧版本）：

# -*- coding: utf-8 -*-

在 Python 3.x 中默认使用 UTF-8，但仍建议统一声明编码格式。

5. 验证与调试技巧

可以使用以下代码片段验证当前控制台编码：

import sys
print(sys.stdout.encoding)
print(sys.getdefaultencoding())
    

输出应为：

utf-8
utf-8
    

6. 高级场景与注意事项

• 使用虚拟环境时，确保虚拟环境中也设置了 PYTHONIOENCODING=utf-8
• 在 CI/CD 环境中部署脚本时，需确保构建节点的控制台编码也为 UTF-8
• 跨平台开发时，建议使用统一的编码检测脚本进行初始化检查
• 对于日志输出，可使用 logging 模块并指定 encoding='utf-8' 参数