安装

VoxelKit Reader 需要 Python 3.9 或更高版本，运行时仅依赖标准库。建议为每个项目使用虚拟环境，避免系统 Python 与项目依赖互相污染。

python3 -m venv .venv
. .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install vfp-reader

安装后使用同一个解释器验证，而不是直接调用可能指向另一个环境的 pip：

python -c "import sys, vfp_reader; print(sys.executable); print(vfp_reader.__file__)"
python -m vfp_reader --help

如果包来自内部索引，追加组织提供的 --index-url 或 --extra-index-url。生产部署应固定具体版本，例如 vfp-reader==1.0.0，并在锁文件中保存哈希或来源信息。

安装失败时先检查 Python 版本和网络/索引权限。不要用 sudo pip 覆盖系统包；在 CI、容器或服务器上优先使用 venv、pipx 或镜像内的隔离解释器。