vscode python print 输出窗口中文乱码

封面图 • 2025-10-30 • Python

在 VSCode 中运行 Python 程序时，如果 `print` 输出的中文出现乱码（如 `??` 或 ``），通常是由于编码设置不正确导致的。以下是几种常见的解决方法：

---

### ✅ 1. **确保文件保存为 UTF-8 编码**

VSCode 默认使用 UTF-8 编码，但有时可能会被更改。请检查：

- 右下角状态栏中显示的编码（如 `UTF-8`）。
- 如果不是，点击它，选择 **"Save with Encoding"**，然后选择 **UTF-8**。

---

### ✅ 2. **在代码中指定编码（可选）**

虽然一般不需要，但你可以在文件开头加上：

```python
# -*- coding: utf-8 -*-
```

---

### ✅ 3. **检查终端编码设置**

如果你是在 **Integrated Terminal** 中运行程序，可能需要设置终端的编码为 UTF-8。

#### Windows（CMD / PowerShell）：
- CMD 不支持 UTF-8，建议使用 **Windows Terminal** 或 **PowerShell**。
- 在 PowerShell 中，可以运行以下命令：

```powershell
chcp 65001
```

这会将代码页改为 UTF-8。

#### macOS/Linux：
默认是 UTF-8，通常不会有问题。

---

### ✅ 4. **在 Python 脚本中设置标准输出编码**

有时候即使文件是 UTF-8，Python 的标准输出也可能没有正确设置。你可以尝试在脚本中添加：

```python
import sys
import io

sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
```

或者直接设置环境变量：

```python
import os
os.environ['PYTHONIOENCODING'] = 'utf-8'
```

---

### ✅ 5. **检查 VSCode 设置**

打开 VSCode 的设置（`File > Preferences > Settings` 或 `Ctrl + ,`）：

搜索 `files.encoding`，确保设置为：

```json
"files.encoding": "utf8"
```

---

### ✅ 6. **使用 `print` 时确保字符串是 Unicode**

如果你从外部读取数据（如文件、网络等），要确保它们是正确的 Unicode 字符串。例如：

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

---

### ✅ 7. **检查系统区域设置（Windows）**

有些情况下，系统区域设置也会影响字符编码。可以尝试：

- 控制面板 → 区域和语言 → 管理 → 更改系统区域设置 → 勾选“Beta: 使用 Unicode UTF-8”（需要重启）。

---

## 🧪 示例代码

```python
import sys
import os

# 设置环境变量
os.environ['PYTHONIOENCODING'] = 'utf-8'

# 设置 stdout 编码
sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')

print("你好，世界！")
```

---

如果你能提供更具体的错误信息或截图，我可以进一步帮助你定位问题。欢迎继续提问！