sp

一个将C语言现代化、提升开发体验的单头文件标准库。

安装使用

复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：

帮我安装这个 AI Skill：sp。
它的用途是：一个将C语言现代化、提升开发体验的单头文件标准库。
详细介绍见：https://321skill.com/skills/sp/
请根据该页面的说明完成安装。

“帮我用sp.h写一个遍历指定目录并列出所有文件名的C程序。”，它会生成包含sp_fs模块使用示例的代码，演示如何获取当前目录、收集文件条目并进行安全遍历。或者

对AI说：“解释一下sp.h中sp_str_t和传统C字符串的区别。”，它会详细说明零拷贝、视图和内存安全方面的优势。

sp.h 旨在解决C语言开发中常见的繁琐、不安全和功能缺失问题，通过一个单头文件库，为C语言注入现代编程语言的便利性和安全性。它提供了类型安全的格式化输出、零拷贝字符串、文件系统操作、动态数组、哈希表、子进程管理、I/O等丰富功能，覆盖了从基础数据结构到系统交互的广泛需求。

使用极其简单，只需下载sp.h头文件，在单个C文件中定义SP_IMPLEMENTATION宏后包含即可，无需额外依赖或复杂的构建步骤。它支持跨平台（Linux、macOS、Windows）、跨架构（x86、ARM、WASM）和多种编译器与C库环境，甚至可以独立于libc运行。

该库非常适合需要在C语言项目中追求更高开发效率、代码安全性和可维护性的开发者。无论是系统编程、嵌入式开发、工具开发还是教学演示，sp.h都能显著降低C语言开发的复杂度。

建议将其作为项目的基础库引入，或仅挑选所需模块使用。由于其设计为单头文件且无依赖，可以轻松集成到现有项目中。注意，它旨在替代或补充标准C库的部分功能，对于深度依赖特定平台API或追求极致性能的特定场景，可能需要评估其实现是否完全符合需求。

与同类C语言工具库（如stb库）相比，sp.h提供了更完整、更现代化的API设计（如类型安全的格式化、零拷贝字符串和类似C++标准库的文件系统操作），并且完全不依赖libc，实现了真正的可移植性和嵌入式友好。其模块化设计允许开发者仅使用所需部分，而无需引入整个库的负担。

不适合对运行时性能有极端要求、或必须严格遵循特定平台原生API（而非sp.h抽象层）的系统核心组件开发。

sp.h和标准C库（libc）冲突吗？

不冲突，sp.h可以独立于libc使用，也可以与libc共存，它提供了许多更现代、更安全的替代API。

如何只使用sp.h的某个模块（比如哈希表）？

sp.h是模块化的，包含头文件后，编译器只会编译你代码中实际用到的部分，你可以自由选择使用任意模块。