VS Code运行Python出现中文乱码或无输出的编码设置方法

一颗松果
一颗松果
发布时间:2026-11-18| 6人浏览过
原创

详细说明在 VS Code 中运行 Python 时出现中文乱码或无输出的原因以及如何通过编码设置解决问题。

在使用 VS Code 编写并运行 Python 脚本时,常会遇到中文字符出现乱码或程序没有任何输出的情况。这通常是因为编辑器、终端以及 Python 解释器使用的字符编码不一致导致的。下面我们逐步说明如何排查并统一编码设置,让中文能够正确显示。

一、确认问题表现

典型症状包括:

  • 在 print("中文测试") 时,终端显示 ?? 或乱码。
  • 脚本执行后没有任何输出,甚至提示 UnicodeDecodeError。

二、检查 VS Code 编辑器编码

确保文件本身保存为 UTF-8 编码:

  1. 打开需要编辑的 .py 文件。
  2. 点击右下角状态栏的 UTF-8(如果显示的是其他编码,点击后在弹出框中选择 Save with Encoding → UTF-8)。
  3. 保存文件。

以下示意图展示了状态栏的操作方式:

VS Code运行Python出现中文乱码或无输出的编码设置方法

三、配置终端编码

VS Code 内置终端需要使用 UTF-8 编码才能正确显示中文。打开设置(Ctrl+,),搜索 terminal.integrated.locale,确保其值为 en-US(默认使用 UTF-8)。如果使用的是外部终端(如 iTerm、PowerShell),同样需要将其字符集改为 UTF-8。

VS Code运行Python出现中文乱码或无输出的编码设置方法

四、确保 Python 解释器使用 UTF-8

在脚本开头添加以下两行代码,强制设置默认编码:

# -*- coding: utf-8 -*-
import sys
sys.stdout.reconfigure(encoding='utf-8')

这一步在 Python 3.7+ 特别有效,因为它会让标准输出流使用 UTF-8 编码。

五、完整示例

下面给出一个完整的示例脚本,演示从文件读取并打印中文:

# -*- coding: utf-8 -*-
import sys
sys.stdout.reconfigure(encoding='utf-8')

with open('demo.txt', 'r', encoding='utf-8') as f:
    content = f.read()
    print(content)

将 demo.txt 保存为 UTF-8 编码后,使用 VS Code 运行该脚本,即可在终端看到正确的中文。

六、故障排查小结

  1. 文件保存为 UTF-8 → VS Code 状态栏检查。
  2. 终端编码设置为 UTF-8 → Settings → terminal.integrated.locale。
  3. Python 标准输出强制 UTF-8 → sys.stdout.reconfigure。
  4. 读取文件时显式指定 encoding='utf-8'。

只要以上四点全部满足,中文乱码或无输出的问题基本可以被彻底解决。

七、配图总结

下面是一张整体流程图,展示了编辑器、终端以及解释器之间的编码流向:

VS Code运行Python出现中文乱码或无输出的编码设置方法

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。