<think>我们遇到了一个文件路径错误：`FileNotFoundError: [Errno 2] No such file or directory: 'D:\usr\share\fonts\truetype\wqy\wqy-zenhei.ttc'` 这个错误表明程序试图在路径`D:\usr\share\fonts\truetype\wqy\wqy-zenhei.ttc`下加载字体文件，但该路径不存在。 原因分析： 1. 该路径看起来像是Linux路径（`/usr/share/fonts/...`）被直接映射到了Windows驱动器`D:`上，但实际在Windows系统中，字体通常安装在`C:\Windows\Fonts`目录下。 2. 可能代码中硬编码了Linux的字体路径，而在Windows环境下运行时没有调整。 解决方案： 步骤1：确认系统中是否存在该字体文件 - 在Windows系统中，打开`C:\Windows\Fonts`目录，查看是否有`wqy-zenhei.ttc`（文泉驿正黑体）或其他中文字体（如simhei.ttf，simsun.ttc等）。 - 如果没有，需要先安装中文字体。可以从网上下载文泉驿字体（例如从https://sourceforge.net/projects/wqy/）并安装。 步骤2：修改代码，使用正确的字体路径 根据你的操作系统动态设置字体路径： 方法一：使用跨平台的字体路径设置 我们可以编写一个函数，根据不同的操作系统返回对应的字体路径。 例如： ```python import platform def get_font_path(): system = platform.system() if system == 'Windows': # 在Windows上，我们使用黑体（simhei.ttf）或宋体（simsun.ttc）等 # 先尝试返回一个常见的黑体路径 return 'C:/Windows/Fonts/simhei.ttf' elif system == 'Linux': # 在Linux上，使用文泉驿正黑 return '/usr/share/fonts/truetype/wqy/wqy-zenhei.ttc' elif system == 'Darwin': # macOS return '/System/Library/Fonts/PingFang.ttc' else: # 其他系统，尝试返回一个默认字体，或者抛出一个错误 return None # 使用示例 font_path = get_font_path() ``` 方法二：在代码中捕获异常并尝试其他字体 如果第一个字体文件不存在，可以尝试其他备选字体。 例如： ```python font_paths = [ 'D:/usr/share/fonts/truetype/wqy/wqy-zenhei.ttc', # 原始路径（可能不存在） 'C:/Windows/Fonts/simhei.ttf', # 黑体 'C:/Windows/Fonts/simsun.ttc', # 宋体 'C:/Windows/Fonts/msyh.ttc', # 微软雅黑 ] font = None for path in font_paths: try: font = ImageFont.truetype(path, 24) # 以Pillow为例 break except IOError: continue if font is None: # 尝试使用默认字体，但可能不支持中文 font = ImageFont.load_default() # 或者抛出异常，提示安装字体 raise Exception("没有找到可用的中文字体，请安装文泉驿正黑或黑体等字体。") ``` 步骤3：安装缺失的字体（可选） 如果系统中确实没有中文字体，需要安装。在Windows上，可以下载字体文件（.ttf或.ttc）后，右键点击选择“安装”。 步骤4：更新字体缓存（仅Linux和macOS需要） 在Linux或macOS上安装新字体后，可能需要运行`fc-cache -fv`更新字体缓存。 步骤5：验证字体是否可用 可以运行以下代码查看系统中已安装的字体（以matplotlib为例）： ```python import matplotlib.font_manager print([f.name for f in matplotlib.font_manager.fontManager.ttflist]) ``` 针对你遇到的错误，由于路径`D:\usr\share\fonts\truetype\wqy\wqy-zenhei.ttc`不存在，建议采用上述跨平台方法或备选字体列表方法。 注意：在Windows系统中，路径分隔符可以使用`/`或`\\`，但为了避免转义问题，建议使用`/`或原始字符串（如`r"C:\Windows\Fonts\..."`）。 如果问题仍然存在，请检查字体文件是否确实存在于你指定的路径，并确保程序有权限访问该路径。 引用说明：在Docker容器中安装字体的方法（引用[1]）适用于Linux环境，但当前问题发生在Windows本地环境，因此主要关注本地字体配置。 §§相关问题§§ 1. 如何在Windows系统中安装新的中文字体？ 2. Python中如何实现跨平台的字体路径配置？ 3. 如何检查Python环境中可用的字体列表？ 4. 在Docker容器中运行Python程序时如何避免中文字体缺失？ </think> ### 解决Python字体路径报错：FileNotFoundError的完整方案 这个错误表明程序无法在指定路径找到字体文件，通常由三种原因导致： 1. 字体文件未正确安装 2. 代码中的字体路径与实际路径不匹配 3. 路径分隔符格式错误（特别是Windows系统） --- ### 一、解决方案步骤 #### 1. 确认系统中文字体安装状态 ```python # 检查系统是否安装中文字体（Windows系统） import os print("C:/Windows/Fonts/目录下的字体:") print(os.listdir("C:/Windows/Fonts/")[:10]) # 显示前10个字体文件 ``` #### 2. 获取正确的字体路径（跨平台方法） ```python import matplotlib.font_manager as fm import platform def get_chinese_font(): """自动获取系统中可用的中文字体路径""" system = platform.system() # Windows系统字体路径 if system == 'Windows': for font in ['simhei.ttf', 'msyh.ttc', 'simsun.ttc']: # 黑体/雅黑/宋体 path = f"C:/Windows/Fonts/{font}" if os.path.exists(path): return path # Linux系统字体路径 elif system == 'Linux': linux_fonts = [ '/usr/share/fonts/truetype/wqy/wqy-zenhei.ttc', '/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc' ] for path in linux_fonts: if os.path.exists(path): return path # macOS系统字体路径 elif system == 'Darwin': return '/System/Library/Fonts/PingFang.ttc' # 苹方字体 # 找不到字体时抛出异常 raise FileNotFoundError("未找到系统中文字体，请先安装中文字体包") # 使用示例 font_path = get_chinese_font() print(f"使用的字体路径: {font_path}") ``` #### 3. 修复路径格式问题（Windows特别注意） ```python # 错误路径示例（反斜杠未转义） wrong_path = "D:\usr\share\fonts\truetype\wqy\wqy-zenhei.ttc" # 正确修正方式（三种选择） correct_path1 = r"D:\usr\share\fonts\truetype\wqy\wqy-zenhei.ttc" # 原始字符串 correct_path2 = "D:/usr/share/fonts/truetype/wqy/wqy-zenhei.ttc" # 正斜杠 correct_path3 = "D:\\usr\\share\\fonts\\truetype\\wqy\\wqy-zenhei.ttc" # 双反斜杠 ``` #### 4. 安全加载字体（带异常处理） ```python from PIL import ImageFont try: font = ImageFont.truetype(font_path, 24) except IOError: # 备选方案1：使用默认字体（可能不支持中文） font = ImageFont.load_default() print("⚠️ 使用默认字体，中文可能显示为方框") # 备选方案2：下载临时字体 import requests url = "https://github.com/googlefonts/noto-cjk/raw/main/Sans/OTF/SimplifiedChinese/NotoSansCJK-Regular.ttf" response = requests.get(url) font = ImageFont.truetype(BytesIO(response.content), 24) ``` --- ### 二、不同库的具体配置方法 #### 1. Matplotlib 配置 ```python import matplotlib.pyplot as plt from matplotlib.font_manager import FontProperties font_path = get_chinese_font() # 使用上述函数 chinese_font = FontProperties(fname=font_path) plt.rcParams['font.family'] = 'sans-serif' plt.rcParams['font.sans-serif'] = [chinese_font.get_name()] plt.rcParams['axes.unicode_minus'] = False # 解决负号显示 # 使用示例 plt.plot([1, 2, 3], [4, 5, 6]) plt.title('中文标题', fontproperties=chinese_font) plt.show() ``` #### 2. Pillow 配置 ```python from PIL import Image, ImageDraw font_path = get_chinese_font() # 使用上述函数 try: font = ImageFont.truetype(font_path, 24) except IOError: font = ImageFont.load_default() img = Image.new('RGB', (400, 200), color=(255, 255, 255)) draw = ImageDraw.Draw(img) draw.text((50, 80), "中文测试", fill=(0, 0, 0), font=font) img.save('output.png') ``` #### 3. 通用字体检查方法 ```python # 列出所有支持中文的字体 from matplotlib.font_manager import fontManager print("可用中文字体:") for font in fontManager.ttflist: if any('CJK' in name for name in font.getname()): print(f"- {font.fname}") ``` --- ### 三、字体安装指南（针对缺失情况） #### Windows系统安装字体： 1. 下载中文字体（如[思源黑体](https://github.com/adobe-fonts/source-han-sans/tree/release)） 2. 右键字体文件 → 选择"安装" 3. 重启Python进程 #### Linux系统安装字体： ```bash # Ubuntu/Debian sudo apt install fonts-noto-cjk -y # CentOS/RHEL sudo yum install adobe-source-han-sans-cn-fonts -y ``` #### Docker容器中安装： ```dockerfile FROM python:3.9 # 安装中文字体 RUN apt-get update && apt-get install -y fonts-noto-cjk # 验证安装 RUN fc-list :lang=zh | grep "Noto Sans CJK" ``` > **关键提示**：开发环境与生产环境路径可能不同，建议使用上述`get_chinese_font()`函数自动检测路径[^1]。 ---