【Python】已完美解决：SyntaxError: Non-UTF-8 code starting with ‘æ‘ in file E:/Python/3.py on line 4, but no-CSDN博客

个人简介：某不知名博主，致力于全栈领域的优质博客分享 | 用最优质的内容带来最舒适的阅读体验！文末获取免费IT学习资料！

🍅 文末获取更多信息 🍅 👇🏻 精彩专栏推荐订阅收藏 👇🏻

专栏系列	直达链接	相关介绍
书籍分享	点我跳转	书籍作为获取知识的重要途径，对于IT从业者来说更是不可或缺的资源。不定期更新IT图书，并在评论区抽取随机粉丝，书籍免费包邮到家
AI前沿	点我跳转	探讨人工智能技术领域的最新发展和创新，涵盖机器学习、深度学习、自然语言处理、计算机视觉等领域的研究进展和趋势分析。通过深入解读前沿技术、案例研究和行业动向，为读者带来关于人工智能未来发展方向和应用前景的洞察和启发。
Elasticsearch	点我跳转	详解 Elasticsearch 搜索和数据分析引擎
科技前沿	点我跳转	本档是关于科技和互联网的专栏，旨在为读者提供有趣、有用、有深度的科技资讯和思考。从多个角度探讨科技与人类生活的关系，包括但不限于科技趋势、产品评测、技术解读、行业观察、创业故事等内容。希望通过本栏，与读者分享科技的魅力和思考，让科技成为我们生活的一部分，而不仅仅是一个陌生的词汇。
Java之光	点我跳转	本栏将带领读者深入探索Java编程世界的种种奥秘。无论你是初学者还是资深开发者，这里都将为你提供丰富的Java知识和实用的编程技巧。
Linux学习日志	点我跳转	本专栏致力于探索Linux操作系统的各个方面，包括基础知识、系统管理、网络配置、安全性等。通过深入浅出的文章和实践指南，帮助读者更好地理解和应用Linux，提高系统管理和开发技能。无论你是初学者还是有经验的Linux用户，都能在本专栏中找到有用的信息和解决方案。
MySQL之旅	点我跳转	专栏将带领读者进入MySQL数据库的世界，探索其强大的功能和应用。我们将深入探讨MySQL的基本概念、SQL语言的应用、数据库设计与优化、数据备份与恢复等方面的知识，并结合实际案例进行讲解和实践操作。
精通Python百日计划	点我跳转	我们将引领你踏上一段为期100天的编程之旅，逐步深入了解和掌握Python编程语言。无论你是编程新手还是有一定基础的开发者，这个专栏都会为你提供系统而全面的学习路径，帮助你在短短100天内成为Python高手。

文章目录

一、问题背景

在Python编程中，经常需要处理各种文本文件。然而，当文件不是以UTF-8编码保存时，Python解释器在读取文件时可能会遇到SyntaxError错误，提示类似“Non-UTF-8 code starting with ‘æ‘ in file … but no encoding declared”的错误信息。这种错误通常发生在文件包含非ASCII字符（如中文字符）且没有正确指定编码方式时。

二、可能出错的原因

文件编码不正确：文件可能不是以UTF-8编码保存的，而是使用了其他编码，如GBK、GB2312或ISO-8859-1等。
Python默认编码：Python 3默认使用UTF-8编码，但在读取文件时，如果没有指定编码方式，它可能会尝试使用默认的编码来解码文件内容，从而导致错误。
编辑器或IDE设置：文本编辑器或集成开发环境（IDE）的编码设置可能与文件实际的编码方式不匹配。

三、错误代码示例

假设我们有一个名为3.py的Python文件，其中包含了非UTF-8编码的文本（如中文字符），并且没有指定编码方式。

# 假设此文件包含非UTF-8编码的文本，如中文字符  
print("你好，世界！")

如果我们直接运行这个文件，Python解释器可能会报出上述的SyntaxError错误。

四、正确代码示例（结合实战场景）

为了解决这个问题，我们需要在打开文件时明确指定文件的编码方式。对于Python脚本文件本身，如果包含非UTF-8字符，通常需要在文件开头添加特殊的注释来指定编码方式。例如，如果文件是GBK编码的，我们可以在文件的第一行或第二行添加以下注释：

# -*- coding: gbk -*-  
# 或者  
# coding=gbk  
  
print("你好，世界！")

但是，请注意，对于Python源文件，我们通常建议使用UTF-8编码，因为Python 3默认使用UTF-8。如果确实需要使用其他编码，才需要在文件中指定。

对于读取或写入文件的操作，我们需要在打开文件时指定编码方式。例如：

# 读取GBK编码的文件  
with open('example.txt', 'r', encoding='gbk') as f:  
    content = f.read()  
print(content)  
  
# 写入文件时指定编码方式（默认为UTF-8）  
with open('output.txt', 'w', encoding='utf-8') as f:  
    f.write("你好，世界！")

五、注意事项

推荐使用UTF-8编码：UTF-8编码是国际上广泛使用的编码方式，支持几乎所有语言的字符，并且与ASCII编码兼容。因此，在编写Python代码或处理文本文件时，建议尽量使用UTF-8编码。
检查文本编辑器和IDE的设置：确保你的文本编辑器或IDE的编码设置与你的文件编码方式一致。这样可以避免在保存文件时发生编码转换错误。
明确指定编码方式：在读取或写入文件时，尽量明确指定文件的编码方式，以避免因编码不匹配而导致的错误。