Eclipse + PyDev 解決 Python 代碼中文編碼問題完整指南

問題背景

Eclipse + PyDev 開發 Python 時，代碼包含中文註釋或字符串直接運行報錯（編碼錯誤）。需從工作區、編輯器、文件模板三個層面徹底解決。

步驟一：設置工作區與編輯器編碼為 UTF-8

1. Window → Preferences → General → Editors → Text Editors → Spelling → Encoding → Other: UTF-8
2. Window → Preferences → General → Workspace → Text file encoding → Other: UTF-8

步驟二：每個模塊首行聲明編碼（關鍵）

在每個 .py 文件第一行添加：

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

或

# coding=utf-8

Python 解析器讀取此聲明決定源文件編碼，缺失時默認 ASCII 導致中文報錯。

步驟三：設置 PyDev 文件模板自動添加編碼聲明

避免每次手動添加：

1. Window → Preferences → PyDev → Editor → Templates
2. 選中 Empty 模板 → Edit
3. 在模板內容開頭插入 ${coding:utf-8} 或直接寫 # -*- coding: utf-8 -*-
4. Apply → OK

驗證

新建 Python 模塊，自動包含編碼聲明與作者信息，代碼中寫中文註釋/字符串運行無報錯。

補充說明

• Python 3 默認源文件編碼即為 UTF-8，但顯式聲明仍是良好習慣，兼容 Python 2 且明確意圖。
• 若運行時仍報錯，檢查文件實際保存編碼（右鍵 Properties → Resource → Text file encoding）是否為 UTF-8。
• 控制台輸出中文亂碼時，在 Run Configurations → Common → Encoding 設置為 UTF-8。

出處：博客原文