https://synodriver.github.io/tags/c/Recent content in C on syno blogHugolocaleSat, 23 May 2026 12:39:09 +0800https://synodriver.github.io/post/nginx-unit-architecture/Sat, 23 May 2026 12:39:09 +0800https://synodriver.github.io/post/nginx-unit-architecture/<p><del>虽然NGINX Unit已经archive了，但它是少有的用C实现异步python调用对象的例子，这个验尸还是有意义的</del></p> <h2 id="1-nginx-unit-整体架构">1. NGINX Unit 整体架构</h2> <p>NGINX Unit 是一个开源的多语言应用服务器，由 NGINX Inc. 开发。与传统的 NGINX 不同，Unit 不仅支持静态文件服务和反向代理，还内建了多种语言运行时的直接支持，包括 Python、Go、Java、Node.js、Perl、Ruby 和 WebAssembly。</p>https://synodriver.github.io/post/lua-nginx-module-architecture/Fri, 15 May 2026 00:26:40 +0800https://synodriver.github.io/post/lua-nginx-module-architecture/<h1 id="lua-nginx-module-设计思路与架构深度剖析">lua-nginx-module 设计思路与架构深度剖析</h1> <h2 id="概述">概述</h2> <p><a href="https://github.com/openresty/lua-nginx-module">lua-nginx-module</a>（又称 <code>ngx_lua</code>）是一个将 LuaJIT 嵌入 Nginx HTTP 服务器的 C 语言模块，是 <a href="https://openresty.org">OpenResty</a> 的核心组件。它通过将 Lua 协程与 Nginx 事件模型深度融合，实现了 <strong>100% 非阻塞</strong> 的网络 I/O 操作，使得在 Nginx 中编写高性能 Web 应用成为可能。本文基于模块源码（v0.10.29），从设计哲学、核心架构、关键机制等多个维度进行深入剖析。</p>https://synodriver.github.io/post/pep7/Mon, 04 May 2026 22:39:16 +0800https://synodriver.github.io/post/pep7/<h1 id="pep-7--c-代码风格指南">PEP 7 – C 代码风格指南</h1> <table> <thead> <tr> <th>字段</th> <th>内容</th> </tr> </thead> <tbody> <tr> <td>作者</td> <td>Guido van Rossum &lt;guido at python.org&gt;, Barry Warsaw &lt;barry at python.org&gt;</td> </tr> <tr> <td>状态</td> <td>活跃（Active）</td> </tr> <tr> <td>类型</td> <td>流程（Process）</td> </tr> <tr> <td>创建日期</td> <td>2001-07-05</td> </tr> </tbody> </table> <hr> <h2 id="目录">目录</h2> <ul> <li><a href="#%E5%BC%95%E8%A8%80">引言</a></li> <li><a href="#c-%E6%A0%87%E5%87%86">C 标准</a></li> <li><a href="#%E9%80%9A%E7%94%A8-c-%E4%BB%A3%E7%A0%81%E7%BA%A6%E5%AE%9A">通用 C 代码约定</a></li> <li><a href="#%E4%BB%A3%E7%A0%81%E6%8E%92%E7%89%88">代码排版</a></li> <li><a href="#%E5%91%BD%E5%90%8D%E7%BA%A6%E5%AE%9A">命名约定</a></li> <li><a href="#%E6%96%87%E6%A1%A3%E5%AD%97%E7%AC%A6%E4%B8%B2">文档字符串</a></li> <li><a href="#%E7%89%88%E6%9D%83">版权</a></li> </ul> <h2 id="引言">引言</h2> <p>本文档为构成 Python C 实现的 C 代码提供了编码规范。请参阅描述 Python 代码风格指南的配套信息性 PEP。</p>https://synodriver.github.io/post/esphome-instructions-zh/Tue, 28 Apr 2026 22:10:28 +0800https://synodriver.github.io/post/esphome-instructions-zh/<h1 id="esphome-ai-协作指南">ESPHome AI 协作指南</h1> <p>本文档为与本项目交互的 AI 模型提供必要的上下文。遵循这些指南将确保一致性并维护代码质量。</p> <h2 id="1-项目概述与目标">1. 项目概述与目标</h2> <ul> <li><strong>主要目标：</strong> ESPHome 是一个使用简单而强大的 YAML 配置文件来配置微控制器（如 ESP32、ESP8266、RP2040 以及基于 LibreTiny 的芯片）的系统。它生成可被编译并烧录到这些设备的 C++ 固件，允许用户通过家庭自动化系统远程控制它们。</li> <li><strong>业务领域：</strong> 物联网（IoT）、家庭自动化。</li> </ul> <h2 id="2-核心技术栈">2. 核心技术栈</h2> <ul> <li><strong>语言：</strong> Python（&gt;=3.11）、C++（gnu++20）</li> <li><strong>框架与运行时：</strong> PlatformIO、Arduino、ESP-IDF。</li> <li><strong>构建系统：</strong> PlatformIO 是主要构建系统，CMake 作为替代方案。</li> <li><strong>配置：</strong> YAML。</li> <li><strong>关键库/依赖：</strong> <ul> <li><strong>Python：</strong> <code>voluptuous</code>（配置验证）、<code>PyYAML</code>（解析配置文件）、<code>paho-mqtt</code>（MQTT 通信）、<code>tornado</code>（Web 服务器）、<code>aioesphomeapi</code>（原生 API）。</li> <li><strong>C++：</strong> <code>ArduinoJson</code>（JSON 序列化/反序列化）、<code>AsyncMqttClient-esphome</code>（MQTT）、<code>ESPAsyncWebServer</code>（Web 服务器）。</li> </ul> </li> <li><strong>包管理器：</strong> <code>pip</code>（Python 依赖）、<code>platformio</code>（C++/PlatformIO 依赖）。</li> <li><strong>通信协议：</strong> Protobuf（原生 API）、MQTT、HTTP。</li> </ul> <h2 id="3-架构模式">3. 架构模式</h2> <ul> <li> <p><strong>整体架构：</strong> 本项目采用代码生成架构。Python 代码解析用户定义的 YAML 配置文件，并生成 C++ 源代码。随后，该 C++ 代码通过 PlatformIO 被编译并烧录到目标微控制器。</p>