常见错误示例

# 示例.py
print("Hello")  # 这是一个中文注释
            

运行结果：SyntaxError: Non-UTF-8 code starting with '\xd6' in file...

方法一：添加文件编码声明（推荐）

在Python文件开头添加编码声明是最常用的解决方案：

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

def main():
    # 这是一个中文注释，现在可以正常使用了
    print("中文注释已正确编码")
    
if __name__ == "__main__":
    main()

优点： 符合PEP 263规范，明确指定文件编码

方法二：使用Unicode转义序列

在不方便修改文件编码时，可以使用Unicode转义序列：

# 使用\u4E2D\u6587\u6CE8\u91CA 表示"中文注释"
print("Hello")  # \u8FD9\u662F\u4E00\u4E2A\u4F8B\u5B50

注意： 这种方法可读性较差，只适合少量中文注释的场景

方法三：配置开发环境使用UTF-8编码

在IDE或编辑器中设置默认编码为UTF-8：

• VSCode： 设置"files.encoding": "utf8"
• PyCharm： File > Settings > Editor > File Encodings
• Sublime Text： File > Save with Encoding > UTF-8

最佳实践： 同时使用编码声明和环境配置

Q1：Python 3还需要编码声明吗？

Python 3默认使用UTF-8编码，但为了确保在所有环境中正常工作，仍然建议添加编码声明。

Q2：编码声明应该放在什么位置？

编码声明必须是文件的第一行或第二行（如果第一行是UNIX shebang）。

#!/usr/bin/env python3
# -*- coding: utf-8 -*-

Q3：除了注释，还有什么地方需要注意编码？

字符串处理、文件读写、网络传输等涉及文本的地方都需要注意编码问题。

#!/usr/bin/env python3
# -*- coding: utf-8 -*-

"""
模块说明：演示Python中文注释的正确使用方法
作者：Python开发者
创建时间：2023年
"""

def calculate_sum(a, b):
    """计算两个数字的和
    
    参数:
        a (int): 第一个数字
        b (int): 第二个数字
        
    返回:
        int: 两个数字的和
    """
    # 返回计算结果
    return a + b

# 主函数
def main():
    """程序入口函数"""
    # 打印欢迎信息
    print("欢迎使用Python中文注释示例")
    
    # 计算并打印结果
    result = calculate_sum(5, 3)
    print("计算结果:", result)

if __name__ == "__main__":
    main()