使用Django5.0.8与Python3.11时UTF-8解码错误（0xf3）求助

排查和解决方法 #

1. 确认源码文件的实际编码 #

Python 3默认用UTF-8读取源码，但如果你的视图文件是用ISO-8859-1、Windows-1252这类编码保存的，就算加了# -*- coding: utf-8 -*-也没用。

• 用VS Code或Notepad++打开文件，检查并修改编码：
  • VS Code：点击右下角的编码标识，选择「通过编码保存」→ UTF-8。
  • Notepad++：在「编码」菜单选择「转为UTF-8（无BOM）」。
    修改后重启项目测试。

2. 临时应急：用Unicode转义替代特殊字符 #

如果暂时无法修改文件编码，直接把特殊字符换成Unicode转义序列，比如把'sómething'改成's\u00f3mething'，Python能直接识别这种写法。

3. 检查模板与Django配置 #

• 模板文件也要确保是UTF-8编码保存，否则即使视图传递正确，模板渲染也可能出问题。
• 打开settings.py确认DEFAULT_CHARSET设置为'utf-8'（Django 5默认是这个值，但可以核对）：

  DEFAULT_CHARSET = 'utf-8'
  

4. 检查系统环境编码 #

系统默认编码非UTF-8也可能引发问题，你可以在视图中添加代码查看当前编码：

import sys
print(sys.getdefaultencoding())
print(sys.stdout.encoding)

如果输出不是UTF-8，启动项目前先设置环境变量：

• Linux/macOS终端：执行export PYTHONIOENCODING=utf-8
• Windows命令行：执行set PYTHONIOENCODING=utf-8
  设置完成后再启动项目。

5. 替换过时的RequestContext #

Django 3.0之后已弃用RequestContext，直接用字典传递上下文即可，这可能解决编码相关的隐性问题：

context = {
    'title': 'sómething',
    'formLogin': formLogin
}
return render(request, '你的模板路径.html', context)

内容的提问来源于stack exchange，提问作者M. Gar