<think>这个错误是因为在读取YAML配置文件时，默认使用了'gbk'编码，而文件可能是以UTF-8编码保存的（特别是当文件中包含非ASCII字符或使用某些编辑器保存时）。在Windows平台上，默认编码是gbk，所以当文件包含非gbk编码的字符时就会出错。 解决方案： 1. 在打开文件时明确指定编码为UTF-8。 2. 确保配置文件保存为UTF-8编码。 修改`src/utils/path_manager.py`文件中的文件打开部分，将： with open(config_path, 'r') as f: 改为： with open(config_path, 'r', encoding='utf-8') as f: 同时，在创建并写入默认配置文件时，也指定UTF-8编码。 具体修改如下： </think> 这个错误是由于 YAML 文件编码问题导致的。在 Windows 系统上，Python 默认使用 'gbk' 编码打开文件，但您的配置文件可能包含 UTF-8 编码的内容（如注释或特殊字符）。以下是完整的解决方案： ### 修复方案 #### 1. 修改 `src/utils/path_manager.py` 文件 ```python # src/utils/path_manager.py import os import yaml from pathlib import Path import logging # 配置日志 logging.basicConfig(level=logging.INFO) logger = logging.getLogger("PathManager") class PathManager: _instance = None def __new__(cls): if cls._instance is None: cls._instance = super().__new__(cls) cls._instance._init_paths() return cls._instance def _init_paths(self): """初始化路径配置""" # 获取项目根目录 self.root = Path(__file__).resolve().parent.parent.parent logger.info(f"项目根目录: {self.root}") # 创建配置文件目录 config_dir = self.root / "configs" config_dir.mkdir(parents=True, exist_ok=True) # 配置文件路径 config_path = config_dir / "paths.yaml" logger.info(f"配置文件路径: {config_path}") # 默认配置 default_config = { 'paths': { 'test_images': "data/images", 'test_videos': "data/videos", 'models': "models/pretrained", 'output': "output" } } # 检查配置文件是否存在 if not config_path.exists(): logger.warning(f"⚠️ 配置文件不存在: {config_path}") self._create_default_config(config_path, default_config) config = default_config else: try: # 使用 UTF-8 编码打开文件 with open(config_path, 'r', encoding='utf-8') as f: config = yaml.safe_load(f) logger.info("✅ 成功加载配置文件") except Exception as e: logger.error(f"❌ 加载配置文件失败: {e}") logger.warning("⚠️ 使用默认配置") config = default_config # 设置路径 self.test_images = self._resolve_path(config['paths']['test_images']) self.test_videos = self._resolve_path(config['paths']['test_videos']) self.models = self._resolve_path(config['paths']['models']) self.output = self._resolve_path(config['paths']['output']) logger.info(f"测试图像目录: {self.test_images}") logger.info(f"模型目录: {self.models}") logger.info(f"输出目录: {self.output}") def _create_default_config(self, config_path, config): """创建默认配置文件""" try: with open(config_path, 'w', encoding='utf-8') as f: yaml.dump(config, f, allow_unicode=True) logger.info(f"✅ 已创建默认配置文件: {config_path}") except Exception as e: logger.error(f"❌ 创建配置文件失败: {e}") def _resolve_path(self, relative_path): """将相对路径解析为绝对路径并确保目录存在""" full_path = self.root / relative_path # 确保目录存在 full_path.mkdir(parents=True, exist_ok=True) return full_path def get_test_image(self, name="test.jpg"): """获取测试图像路径""" path = self.test_images / name if not path.exists(): logger.warning(f"⚠️ 测试图像不存在: {path}") return path def get_model_path(self, name="yolov10n.pt"): """获取模型路径""" path = self.models / name if not path.exists(): logger.warning(f"⚠️ 模型文件不存在: {path}") return path def get_output_path(self, filename): """获取输出文件路径""" return self.output / filename # 单例实例 path_manager = PathManager() ``` #### 2. 修复 `configs/paths.yaml` 文件编码 1. **删除现有配置文件**（如果存在）： ```bash del configs\paths.yaml ``` 2. **创建新的 UTF-8 编码配置文件**： ```yaml # configs/paths.yaml paths: test_images: "data/images" # 测试图像目录 test_videos: "data/videos" # 测试视频目录 models: "models/pretrained" # 预训练模型目录 output: "output" # 输出结果目录 ``` 3. **确保使用 UTF-8 编码保存**： - 在文本编辑器中（如 VS Code），右下角选择编码为 UTF-8 - 保存文件时选择 "Save with Encoding" > "UTF-8" #### 3. 添加日志配置到 `main.py` ```python # main.py import time import logging from src.core.detection import Detector from src.utils.path_manager import path_manager # 配置日志 logging.basicConfig( level=logging.INFO, format='%(asctime)s - %(name)s - %(levelname)s - %(message)s', handlers=[ logging.StreamHandler(), logging.FileHandler("app.log", encoding='utf-8') ] ) logger = logging.getLogger("Main") def main(): logger.info("🚀 启动目标检测系统...") try: # 初始化检测器 start_time = time.time() detector = Detector() init_time = time.time() - start_time logger.info(f"✅ 检测器初始化完成 - 耗时: {init_time:.2f}秒") # 获取测试图像路径 test_image = path_manager.get_test_image("test.jpg") logger.info(f"🖼️ 使用测试图像: {test_image}") # 执行检测 detect_start = time.time() results = detector.detect(test_image) detect_time = time.time() - detect_start # 输出结果 logger.info(f"\n🔍 检测到 {len(results)} 个对象 - 耗时: {detect_time:.4f}秒") for i, det in enumerate(results): logger.info(f"{i+1}. {det['class']} - 置信度: {det['confidence']:.2f}") # 保存可视化结果 output_path = path_manager.get_output_path("detection_result.jpg") detector.visualize_results(test_image, results, output_path) logger.info("\n🎉 检测完成!") except Exception as e: logger.error(f"\n❌ 发生错误: {e}") import traceback logger.error(traceback.format_exc()) if __name__ == "__main__": main() ``` ### 错误原因分析 1. **编码问题**： ```python # 错误代码 with open(config_path, 'r') as f: config = yaml.safe_load(f) ``` - Windows 默认使用 'gbk' 编码 - 但 YAML 文件可能包含 UTF-8 字符（如中文注释） 2. **解决方案**： ```python # 修复代码 with open(config_path, 'r', encoding='utf-8') as f: config = yaml.safe_load(f) ``` 3. **其他改进**： - 添加详细的日志记录 - 更健壮的错误处理 - 自动创建默认配置 - 路径解析更可靠 ### 验证修复 1. 创建测试目录结构： ```bash mkdir data\images echo "Test image" > data\images\test.jpg ``` 2. 运行程序： ```bash python main.py ``` 3. 预期输出： ``` 2023-10-15 12:00:00 - PathManager - INFO - 项目根目录: C:\Users\22271\Desktop\game_ai 2023-10-15 12:00:00 - PathManager - INFO - 配置文件路径: C:\...\configs\paths.yaml 2023-10-15 12:00:00 - PathManager - INFO - 测试图像目录: C:\...\data\images ... 🚀 启动目标检测系统... ``` ### 预防措施 1. **统一编码**： - 所有代码文件使用 UTF-8 编码 - 在文件开头添加编码声明： ```python # -*- coding: utf-8 -*- ``` 2. **跨平台路径处理**： ```python # 使用 pathlib 替代 os.path from pathlib import Path config_path = Path(__file__).parent / "configs" / "paths.yaml" ``` 3. **环境检查**： ```python import sys print(f"系统编码: {sys.getdefaultencoding()}") print(f"文件系统编码: {sys.getfilesystemencoding()}") ``` 4. **编码检测**： ```python import chardet def detect_encoding(file_path): with open(file_path, 'rb') as f: result = chardet.detect(f.read()) return result['encoding'] ```