- 源代码文件编码：确保你的
.py文件本身被保存为 GBK 编码。 - 运行时 I/O 编码：在程序运行时，对输入（如读取文件）和输出（如写入文件、打印到控制台）进行 GBK 编码。
下面我将详细解释这两个方面,并提供完整的代码示例。
设置源代码文件编码
这是最基础的一步，如果你的 Python 脚本中包含非 ASCII 字符（比如中文注释或字符串），你需要告诉 Python 解释器这个文件是用什么编码保存的。
方法：在文件开头添加“编码声明”
在 Python 文件的第一行或第二行,添加如下注释：
# -*- coding: gbk -*-
或者
# coding=utf-8 # 这是错误的，如果文件实际是GBK编码
重要提示：这个声明必须位于文件的最顶部，前面不能有任何字符（包括空格或空行），并且最好紧跟在 (Shebang) 行之后（如果有的话）。
示例文件 test_gbk_source.py
假设你用文本编辑器（如 Notepad++、VS Code、Sublime Text）将以下内容保存为 test_gbk_source.py，并确保编辑器选择的编码是 GBK。
# -*- coding: gbk -*- # 这是一个包含中文字符的字符串 chinese_str = "你好，世界！" # 这是一个中文注释 print(chinese_str)
如何验证？
运行这个文件，如果一切正常，它会正确打印出 "你好，世界！"，如果文件编码声明和实际文件编码不一致，可能会在解释时抛出 SyntaxError。
运行时 I/O 编码
当你的程序需要从外部读取数据或向外部写入数据时（例如读写文件、与数据库交互、网络请求等），你需要显式地指定使用 GBK 编码。
A. 读取文件 (Read File)
使用 open() 函数的 encoding 参数。
示例：读取一个 GBK 编码的文本文件
假设你有一个名为 input_gbk.txt 的文件，内容是 GBK 编码的中文。
# input_gbk.txt 内容 (用GBK编码保存) # 这是第一行 # 这是第二行，包含中文：你好
Python 代码：
# -*- coding: gbk -*-
# 使用 'r' 模式读取，并指定 encoding='gbk'
try:
with open('input_gbk.txt', 'r', encoding='gbk') as f:
content = f.read()
print("成功读取文件内容：")
print(content)
except FileNotFoundError:
print("错误：文件 'input_gbk.txt' 未找到。")
except UnicodeDecodeError:
print("错误：文件解码失败，请确认文件是否为GBK编码。")
关键点：
encoding='gbk'：这是核心，告诉open()函数文件内容是 GBK 编码的。- 错误处理：如果文件不是 GBK 编码，会抛出
UnicodeDecodeError，使用try...except可以优雅地处理这种错误。 - 推荐使用
with语句：它能确保文件在操作完成后被自动关闭。
B. 写入文件 (Write File)
同样，在写入文件时，也需要指定编码，否则 Python 会使用系统默认编码（通常是 UTF-8），导致写入的文件不是 GBK 编码。
示例：将内容写入一个 GBK 编码的文本文件
# -*- coding: gbk -*-
data_to_write = "这是要写入文件的新内容，\n第二行数据。"
try:
# 使用 'w' 模式写入，并指定 encoding='gbk'
# 如果文件已存在，它将被覆盖
with open('output_gbk.txt', 'w', encoding='gbk') as f:
f.write(data_to_write)
print("成功将内容写入 'output_gbk.txt' 文件。")
except Exception as e:
print(f"写入文件时发生错误: {e}")
# 验证：用记事本或 Notepad++ 打开 output_gbk.txt，查看其编码属性
C. 打印到控制台 (Print to Console)
在大多数现代操作系统（如 Windows 10/11, macOS, Linux）上，终端（控制台）默认支持 UTF-8 编码，即使你的源文件是 GBK 编码，直接打印中文字符通常也能正常显示，因为 Python 内部会处理字符编码的转换。
示例：
# -*- coding: gbk -*- chinese_str = "打印到控制台" print(chinese_str) # 在大多数现代终端上，这能正常工作
注意：如果你在非常旧的 Windows 系统或配置不正确的终端上，可能会看到乱码，解决方法是确保终端的编码设置为 GBK（在 Windows CMD 中可能需要执行 chcp 936 命令），但这通常不推荐，因为 UTF-8 是未来的趋势，最好的做法是让你的所有脚本和文件都统一使用 UTF-8。
总结与最佳实践
| 场景 | 方法 | 代码示例 |
|---|---|---|
| 源代码文件 | 在文件顶部添加编码声明 | # -*- coding: gbk -*- |
| 读取文件 | open() 函数设置 encoding 参数 |
with open('file.txt', 'r', encoding='gbk') as f: |
| 写入文件 | open() 函数设置 encoding 参数 |
with open('file.txt', 'w', encoding='gbk') as f: |
| 打印到控制台 | 通常无需设置，依赖终端默认编码 | print("你好") |
⭐ 强烈建议
虽然 GBK 在处理一些旧的中文环境或特定系统（如 Windows）时仍有必要，但 UTF-8 是目前全球事实上的标准编码，它支持所有字符，并且是 Python 3 的默认编码。
最佳实践是：
- 统一使用 UTF-8：将你的所有 Python 源文件保存为 UTF-8 编码，并在文件中声明
# -*- coding: utf-8 -*-。 - I/O 操作默认使用 UTF-8：在读写文件时，除非有特殊要求（如与一个古老的GBK编码系统交互），否则都使用
encoding='utf-8'。 - 仅在必要时使用 GBK：仅在处理特定遗留系统、读取特定GBK编码的文件或写入必须为GBK格式的文件时，才临时性地使用
encoding='gbk'。
这样可以最大限度地避免编码问题,并让你的代码更具兼容性和可维护性。
