Python 探索编程中的接口

Thu, 21 May 2026 01:40:00 +0800

为什么需要接口链接到标题

随着项目规模不断的增加，越来越多的第三方包，库需要我们去适配，同时需要去考虑可扩展性，可替换性，可替换尤为重要因为这样才能在不同的提供商方便切换，比较典型的例子有：

计算机硬件驱动，同样的功能比如网络，声音，我们可以用不同的网卡，麦克风和音响
大模型提供商，可以在同一服务使用不同的大模型，比如 Openclaw 可以切换不同的模型
数据库选型，都是增删改查，但是我们可以使用不同的数据库去切换

但是，不同的网卡，音响或麦克风他们的厂家都不一致，他们的内部运作方式肯定也不一样，各个大模型（Qwen, Chatgpt, Claude）他们的模型的输入输出的格式都有出入，我们该如何去兼容所有厂商呢？

答案是: 给所有外部提供商提供统一的接口，不用担心外部具体的实现，只关心出入的标准

对于大模型，程序内部我们只需要一个可以返回内容的函数

def chat(user_input: str) -> reply: str:
    ...
    return reply

不同的大模型提供商，我们可以为他们写一个同样的 chat 函数，并且函数参数和返回值都高度保持一致(这有点像函数的重载)，这样我们的业务层就只需要调用 chat 函数，不需要关注内部实现，然后在函数内部就去适配，去转换输入输出类型

# 将自定义的 LLMTool 转换成 OpenAi 可接受的格式
def _to_openai_tools(
    self, tools: list[LLMTool]
) -> list[ChatCompletionToolUnionParam]:
    openai_tools: list[ChatCompletionToolUnionParam] = []

    for tool in tools:
        function_def: FunctionDefinition = {
            "name": tool.name,
            "description": tool.description,
            "parameters": tool.input_schema,
        }

        openai_tool: ChatCompletionFunctionToolParam = {
            "type": "function",
            "function": function_def,
        }

        openai_tools.append(openai_tool)

    return openai_tools

接口如何玩链接到标题

Python 处理接口的方式经历了一个非常有趣的演变：从纯粹的动态“鸭子类型”，进化到了结合静态类型检查的 Protocol（结构化子类型）。

这不仅保留了 Python 的灵活性，还解决了大型项目中代码难以维护和缺乏 IDE 提示的痛点。我们来一步步拆解。

鸭子类型 (Duck Typing)：灵活但不可控鸭子类型是 Python 最核心的动态特性之一。它的哲学是：“如果它走起来像鸭子，叫起来像鸭子，那么它就是鸭子。”

在代码中，这意味着我们不关心对象的真实类型，只关心它是否实现了特定的方法。

关于

Thu, 21 May 2026 01:20:00 +0800

你好，我是雪宁韵链接到标题

GitHub 上我使用的英文名是 zeroicey。目前我把这个小站当作自己的记录空间，用来放一些技术思考、项目探索，以及那些值得慢慢整理下来的想法。

我的一句座右铭是：

去码头整点薯条

我在做什么链接到标题

从 GitHub 上公开能看到的内容来看，我最近关注的方向比较杂，但也很有个人风格：

个人生活记录与健康相关产品
偏安静、克制风格的效率工具
Neovim 插件与开发体验优化
一些更偏底层或图形方向的小项目

当前公开项目里，比较能代表这些兴趣的有：

LifeSync-Health-Ultra-Web：围绕身心协同健康管理的 Web 项目
serenique：强调清晰与平静感的个人生活追踪系统
bufswi.nvim：一个轻量的 Neovim buffer 切换插件
minecraft：使用 C++ 和 raylib 的小型 Minecraft clone

我关心的东西链接到标题

我对“接口”“抽象”“可替换性”这类编程里的基础概念一直很有兴趣。比起只追求把功能先堆出来，我更在意代码是否清楚、是否容易演化、以及不同实现之间能不能平滑切换。

这也是为什么这个博客里会出现一些偏概念、偏思考型的文章。它们不一定都很宏大，但会尽量诚实地记录我当下的理解。

在这里你会看到链接到标题

编程学习过程中的思考与笔记
正在做的项目和一些半成品实验
工具、编辑器、工作流相关折腾
偶尔也会有一点点生活化的表达

联系我链接到标题

GitHub: github.com/zeroicey
Email: zeroicey.hp@gmail.com

雪宁韵

Python 探索编程中的接口

为什么需要接口 链接到标题

接口如何玩 链接到标题

关于

你好，我是雪宁韵 链接到标题

我在做什么 链接到标题

我关心的东西 链接到标题

在这里你会看到 链接到标题