free-stockdb Python SDK安装安装.py一行脚本的原理与.pth模块路径详解【免费下载链接】free-stockdb面向 A 股日K、分钟K与ETF分钟数据的本地量化引擎集成增量同步、本地缓存、复权、批量查询、回测与指标计算。项目地址: https://gitcode.com/GitHub_Trending/fr/free-stockdbfree-stockdb是一款面向 A 股日K、分钟K与 ETF 分钟数据的本地量化数据引擎。它的Python SDK 安装不用pip install只需运行一次 [pybao/安装.py] 脚本就能通过.pth文件把模块路径写入 Python 搜索路径实现任何目录都能import的全局调用效果。3 步完成 Python SDK 安装最快上手1️⃣ 下载发行包并解压双击运行数据更新工具等待数据同步到本地./data目录 2️⃣ 双击启动本地数据库服务stockdb.exe仅 2.2MB默认监听127.0.0.1:7899 3️⃣ 在终端执行一次安装脚本python pybao/安装.py看到成功项目路径已写入到 xxx.pth即安装完成重启 Python 解释器或 IDE后系统任何目录下都能直接使用from stock_sdk import *后续调用示例可参考 [调用方式/python/sdk_test.py] 与 [pybao/stock_sdk.py]。安装.py 源码逐段拆解.pth 到底做了什么[pybao/安装.py] 全文不到 55 行只依赖 Python 标准库核心逻辑分五步第 1 步定位要安装的目录。用os.path.dirname(os.path.abspath(__file__))取脚本自身所在目录也就是pybao/目录——stock_sdk.py、zhibiao.py、stockdb.pyd都在这里。第 2 步选择写入位置免管理员权限。脚本优先使用site.USER_SITE即用户级site-packages 目录普通权限即可写入如果该目录不存在才回退到site.getsitepackages()[0]系统级目录。第 3 步确定 .pth 文件名。以所在目录名命名例如目录叫pybao就生成pybao.pth。第 4 步防重复检查。若.pth已存在先读取内容发现相同路径已写入则直接跳过因此脚本可重复执行不会产生冗余行。第 5 步追加路径。用追加模式把目录绝对路径写入.pth并用os.linesep保证 Windows / macOS / Linux 换行符正确写入失败时给出权限不足等明确提示。.pth 模块路径机制为什么重启解释器就能全局导入原理一句话Python 解释器启动时site模块会自动读取 site-packages 目录下的所有.pth文件把其中每一行路径依次追加到sys.path。所以安装脚本写入的这一行路径等价于让pybao/永久进入模块搜索路径——和pip install注册包的效果类似但省去了打包、metadata 和版本管理环节。这也正是 [pybao/说明_运行-安装.py-即可任何地方调用stockdb类似pip.txt] 中运行一次安装.py后续任何地方均可直接导入包相当于 pip 全局的含义。与 pip install 的区别对比对比项pip installfree-stockdb 安装.py安装方式打包为 wheel/sdist 后安装一行脚本写入.pth路径权限要求可能需要管理员权限用户级 site-packages普通权限即可生效范围对应环境该 Python 用户全局卸载方式pip uninstall删除生成的.pth文件适用场景发布到公共包的软件本地数据引擎、私有 SDK 快速接入常见问题排查清单提示权限不足PermissionError脚本已优先写用户级目录一般不会遇到若回退到系统目录请以管理员身份运行。写入了但不生效.pth在解释器启动时读取必须重启 Python 进程 / IDE才生效。找不到stockdb.pyd底层二进制模块需位于pybao/目录Python 3.8 使用stockdb.pyd3.14t 自由线程版本需将3.14tstockdb.pyd重命名后再用。想卸载 SDK直接删除 site-packages 中的pybao.pth文件即可。安装完成后SDK 能干什么启动本地服务后SDK 提供三类核心接口详见 [pybao/zhibiao.py]、[调用方式/调用说明.txt]批量查询rd.get_data()全市场 7000 代码、任意周期日/周/月/1、5、15、30 分钟、前/后/不复权支持返回 DataFrame指标计算zb.get()内置 39 种技术指标 5 种指数Rust 计算核心数秒出结果板块映射bk.get()申万一二三级行业 1200 概念板块双向查询毫秒级返回。数据同步、查询与计算全部走本机链路回测与策略研究不再受远程 API 限频约束。除 Python 外free-stockdb 还支持 HTTP、Excel/WPS、HTML 网页与 AI MCP 五种调用方式安装脚本正是 Python 与 MCP 两种方式的共同前提。【免费下载链接】free-stockdb面向 A 股日K、分钟K与ETF分钟数据的本地量化引擎集成增量同步、本地缓存、复权、批量查询、回测与指标计算。项目地址: https://gitcode.com/GitHub_Trending/fr/free-stockdb创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考