4. 环境准备与安装

在开始使用金融特征缺失巡检工具之前，必须确保运行环境满足最低系统要求。本章将详细说明操作系统、Python 版本、依赖库的兼容性，提供两种安装方式（pip 安装与源码安装），并给出验证安装是否成功的标准步骤。

4.1 系统要求

工具基于 Python 生态构建，核心依赖包括 pandas、numpy、scikit-learn 及金融数据读取组件。下表列出各平台的最低推荐版本：

4.2 安装步骤

4.2.1 pip 安装（推荐）

pip 安装是最快捷的方式，工具已发布至 PyPI。打开终端或命令提示符，执行以下命令：

pip install fin-missing-inspector

如需安装包含所有可选依赖（如 Excel 支持、可视化组件）的完整版本：

pip install fin-missing-inspector[full]

如果网络环境受限，可使用国内镜像源加速：

pip install fin-missing-inspector -i https://pypi.tuna.tsinghua.edu.cn/simple

4.2.2 源码安装

当需要二次开发或使用最新未发布特性时，推荐源码安装。步骤如下：

1. 克隆仓库

   git clone https://github.com/your-org/fin-missing-inspector.git
   cd fin-missing-inspector

2. 创建虚拟环境（可选但强烈推荐）

   python -m venv venv
   # Windows
   venv\Scripts\activate
   # Linux / macOS
   source venv/bin/activate

3. 安装依赖并构建

   pip install -r requirements.txt
   python setup.py install

4.3 验证安装是否成功

安装完成后，通过以下步骤快速验证工具是否可用：

1. 检查命令行入口

   fin-missing-inspector --version

   应输出类似 fin-missing-inspector 1.2.0 的版本号。
2. 导入 Python 模块

   python -c "from fin_missing_inspector import Inspector; print('Import OK')"

   无报错且输出 Import OK 表示核心模块加载成功。
3. 运行内置自检

   fin-missing-inspector --self-check

   工具将自动检测依赖库版本、数据连接状态，并输出诊断报告。

4.4 常见安装问题与解决