已解决：SyntaxError: Non-UTF-8 code starting with ‘æ’ in file E:/Python/3.py on line 4, but no encoding

已解决：SyntaxError: Non-UTF-8 code starting with ‘æ’ in file E:/Python/3.py on line 4, but no encoding declared

写在前面

在 Python 中，文件编码问题常常引发类似 SyntaxError: Non-UTF-8 code starting with ‘æ’ 的错误。当 Python 解释器尝试读取源文件时，如果文件包含非 UTF-8 编码的字符且没有明确声明编码方式，解释器就会抛出这样的错误。常见的原因是文件保存时使用了其他编码格式（如 Latin-1、GBK 等），而 Python 默认认为源文件是 UTF-8 编码。

问题描述

报错代码行：

SyntaxError: Non-UTF-8 code starting with ‘æ’ in file E:/Python/3.py on line 4, but no encoding declared

报错原因分析

1. 文件包含非 UTF-8 字符：文件中包含诸如 æ 这样的特殊字符，而 Python 默认按照 UTF-8 编码读取文件，导致无法识别这些字符。
2. 未声明编码格式：文件未显式声明编码格式，Python 会按照默认的 UTF-8 编码来解析文件内容。
3. 文件保存时使用了其他编码：如果编辑器在保存文件时使用了非 UTF-8 编码，而代码中未指明文件编码，就会导致 Python 解析失败。

解决思路

1. 查看文件中的特殊字符：检查文件是否包含非 UTF-8 编码的字符，尤其是非英语字符。
2. 指定文件编码：在文件头部声明文件编码，确保 Python 解释器能够正确解析非 UTF-8 字符。
3. 检查文件保存时的编码格式：确保文件在保存时使用 UTF-8 编码，或者根据实际情况指定正确的编码格式。

解决办法

1. 在文件头部指定编码格式

Python 支持在文件的顶部显式声明编码格式，以避免编码错误。可以在文件的第一行或第二行添加如下代码：

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

这行代码告诉 Python 解释器使用 UTF-8 编码解析文件，从而避免因编码问题导致的错误。如果你的文件包含非 UTF-8 字符，但你知道文件是以其他编码（如 GBK、Latin-1）保存的，可以修改为相应的编码格式：

# -*- coding: gbk -*-

2. 修改文件编码为 UTF-8

如果你希望将文件的编码统一为 UTF-8，可以使用文本编辑器（如 VS Code、Sublime Text）将文件重新保存为 UTF-8 编码格式。

• 在 VS Code 中，可以通过点击右下角的编码信息（如 “GBK”），选择 “保存为 UTF-8”。
• 在 Sublime Text 中，可以选择 File -> Save with Encoding -> UTF-8。

3. 使用 chardet 检测文件编码

如果不确定文件的编码，可以使用 Python 的 chardet 库来检测文件的实际编码。首先安装 chardet：

pip install chardet

然后编写代码检测文件的编码：

import chardet

with open('E:/Python/3.py', 'rb') as f:
    result = chardet.detect(f.read())
    print(result['encoding'])

这样可以检测到文件的实际编码格式，并据此进行修改。

4. 修改文本编辑器的默认编码

为避免今后再出现类似问题，可以修改文本编辑器的默认编码为 UTF-8。例如：

• 在 VS Code 中，打开设置 (Ctrl + ,)，搜索 files.encoding，将其设置为 UTF-8。
• 在 Sublime Text 中，打开 Preferences -> Settings，添加 "default_encoding": "UTF-8"。

5. 避免混合编码

如果项目中涉及多种文件格式，确保所有文件使用相同的编码格式（最好统一为 UTF-8）。混合编码会导致不同的解释器或工具处理文件时发生冲突。

总结

SyntaxError: Non-UTF-8 code starting with ‘æ’ 是由文件编码与 Python 解释器默认的 UTF-8 编码不匹配引起的。通过在文件头部声明正确的编码格式、修改文件保存时的编码为 UTF-8 或使用工具检测和转换文件编码，可以轻松解决此类错误。统一使用 UTF-8 编码能够有效避免类似问题在今后的开发中再次发生。