Python打印韩文：从编码到输出的完整指南

一、韩文编码基础与Python环境准备

韩文（한글）作为表音文字系统，其字符编码需符合Unicode标准。Python 3默认使用UTF-8编码，但需确保开发环境与终端支持韩文字符显示。

1. 编码验证
   在Python脚本开头添加编码声明（Python 3可省略）：

   # -*- coding: utf-8 -*-
   print("한글 테스트")  # 直接输出韩文

   若终端显示乱码，需检查系统区域设置或终端编码（如Windows需设置CMD为UTF-8）。

2. IDE与终端配置

   • VS Code：安装”Korean Language Pack”扩展，设置"files.encoding": "utf8"。
   • Jupyter Notebook：内核启动时需确保环境变量PYTHONIOENCODING=utf-8。
   • Linux终端：执行export LANG=ko_KR.UTF-8或修改~/.bashrc。

二、韩文字符输出方法详解

1. 直接打印法

print("안녕하세요")  # 基础韩文输出
print("Python으로 한글 출력하기")  # 混合中韩文

适用场景：简单字符串输出，依赖终端字体支持。

2. 变量与格式化输出

name = "이순신"
age = 30
print(f"{name}님의 나이는 {age}세입니다.")  # f-string格式化

优势：动态内容拼接时保持编码一致性。

3. 文件读写中的韩文处理

# 写入韩文文本文件
with open("korean.txt", "w", encoding="utf-8") as f:
    f.write("한국어 파일 저장 테스트")
# 读取验证
with open("korean.txt", "r", encoding="utf-8") as f:
    print(f.read())

关键点：必须显式指定encoding="utf-8"，否则可能抛出UnicodeDecodeError。

三、常见问题与解决方案

1. 终端显示乱码

原因：终端未使用UTF-8编码。
解决方案：

• Windows CMD：执行chcp 65001切换代码页。
• Linux/Mac：检查locale输出是否包含UTF-8。

2. 字体缺失导致方框显示

现象：韩文字符显示为□□□。
处理步骤：

1. 安装支持韩文的字体（如Noto Sans CJK）。
2. 在图形界面程序中指定字体：

   import matplotlib.pyplot as plt
   plt.rcParams['font.family'] = 'Noto Sans CJK JP'  # 或其他韩文字体
   plt.title("한글 그래프 제목")
   plt.show()

3. 跨平台编码差异

Windows默认编码：CP949（需强制UTF-8）。
Linux/Mac默认编码：UTF-8（通常无需修改）。
统一处理方案：

import sys
import io
# 重定向标准输出为UTF-8编码
sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
print("모든 플랫폼에서 정상 출력")

四、高级应用场景

1. 韩文与Unicode规范

韩文Unicode范围：U+AC00（가）至U+D7AF（ힿ）。
验证方法：

char = "가"
print(hex(ord(char)))  # 输出: 0xac00

2. 韩文输入处理

从用户输入获取韩文：

user_input = input("이름을 입력하세요: ")  # 支持韩文键盘输入
print(f"입력한 이름: {user_input}")

3. 第三方库支持

• PyQt5：设置应用字体：

  from PyQt5.QtWidgets import QApplication, QLabel
  app = QApplication([])
  label = QLabel("PyQt5 한글 테스트")
  label.setFont(QtGui.QFont("Malgun Gothic"))  # Windows韩文字体
  label.show()

五、最佳实践建议

1. 始终显式指定编码：文件操作、网络请求等场景强制使用UTF-8。
2. 测试多平台兼容性：在Windows/Linux/Mac下验证显示效果。
3. 使用版本控制：记录编码相关的配置变更。
4. 异常处理：捕获可能的编码错误：

   try:
       print("안녕".encode('ascii'))  # 故意触发错误
   except UnicodeEncodeError as e:
       print(f"编码错误: {e}")

六、扩展资源

• Unicode韩文区块：U+AC00-U+D7AF
• Python编码文档：Python 3 Unicode指南
• 字体下载：Google Noto Fonts

通过系统掌握编码原理、环境配置和异常处理，开发者可以确保Python程序在各种场景下稳定输出韩文内容。实际应用中，建议结合具体项目需求进行针对性优化，例如在Web开发中配置响应头Content-Type: text/html; charset=utf-8，或在数据分析中确保CSV文件使用UTF-8-BOM格式以兼容Excel。