复现GitHub项目需严格按五步操作：一查README明确环境要求；二建隔离环境（conda/venv）；三依序安装torch、requirements及源码包；四验证torch/CUDA与关键模块；五排查并精准修复依赖冲突。
如果您尝试复现 GitHub 项目中的代码，但运行失败或报错，则可能是由于本地环境与作者原始配置不一致。以下是完成代码复现的完整流程，涵盖环境初始化、依赖安装与版本对齐等关键环节：
一、确认项目 README 与文档信息
项目作者通常在 README.md 中明确标注了运行所需的 Python 版本、框架依赖、硬件要求及预训练模型路径等关键信息。忽略该步骤可能导致后续所有操作无法正常执行。
1、打开 GitHub 项目主页，定位到 README.md 文件。
2、查找包含 Python version、Requirements、Installation 或 Environment 的章节。
3、记录下指定的 Python 小版本号（例如 3.9.16 而非仅写 3.9），以及是否要求 CUDA 版本（如 CUDA 11.8）。
二、创建隔离的 Python 环境
使用虚拟环境可避免系统级 Python 包冲突，并确保复现过程可重复。Conda 更适合科学计算类项目，因其能统一管理 Python、编译器与 CUDA 工具链。
1、若使用 Conda：执行 conda create -n myenv python=3.9.16 创建新环境。
2、激活环境：conda activate myenv。
3、若使用 venv：执行 python3.9 -m venv ./venv，再运行 source venv/bin/activate（Linux/macOS）或 venv\Scripts\activate.bat（Windows）。
三、安装核心依赖包
依赖安装需严格遵循项目提供的顺序和方式，部分包必须通过源码编译（如 detectron2）、部分需指定 wheel 地址（如 torch 对应 CUDA 版本），直接 pip install 可能导致兼容性错误。
1、优先安装 torch：访问 https://pytorch.org/get-started/locally/，根据系统与 CUDA 版本生成对应命令，例如 pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118。
2、安装 requirements.txt 中其余包：pip install -r requirements.txt。
3、若报错提示某包编译失败（如 pycocotools、detectron2），则改用官方推荐方式：例如 pip install 'git+https://github.com/cocodataset/cocoapi.git#subdirectory=PythonAPI'。
四、验证环境与基础功能
在运行主训练脚本前，需确认各组件已正确加载且无版本冲突。此步骤可快速暴露 CUDA 不可用、GPU 未识别或模块导入失败等问题。
1、启动 Python 解释器，执行 import torch; print(torch.__version__, torch.cuda.is_available())，输出应显示匹配版本号与 True。
2、逐个导入项目中关键模块，例如 import numpy as np; import cv2; from models.network import MyNet，任一失败需立即回溯对应包安装步骤。
3、运行项目自带的最小测试脚本（常见于 tests/ 或 examples/ 目录），例如 python tests/test_inference.py。
五、处理常见依赖冲突场景
当 pip install 后仍出现 ImportError 或 AttributeError，往往源于隐式依赖版本错配。此时需人工干预依赖图，而非盲目升级或降级全部包。
1、查看冲突提示中的模块名与行号，定位到报错位置，例如 AttributeError: module 'torch' has no attribute 'compile' 表明 torch 版本过低（需 ≥2.0）。
2、使用 pip show package_name 查看已安装版本，并比对项目 issue 区中其他用户确认有效的组合（如 transformers==4.35.2 + tokenizers==0.14.1）。
3、对关键包执行精确降级：pip install torch==2.0.1+cu118 -f https://download.pytorch.org/whl/torch_stable.html，注意保留 +cu118 后缀以维持 CUDA 支持。
