如何快速搭建Paozhu（炮竹）C++开发环境：Linux、Mac、Windows三平台CMake/xmake/vcpkg完整指南

如何快速搭建Paozhu炮竹C开发环境Linux、Mac、Windows三平台CMake/xmake/vcpkg完整指南【免费下载链接】paozhuPaozhu C Web Framework,(Based on C20) Support HTTP/1 HTTP/2, Rapid development of CRUD web applications, Include modules HttpServer HttpClient WebSocket ORM项目地址: https://gitcode.com/gh_mirrors/pa/paozhuPaozhu炮竹是一款基于C20的高性能 C Web 框架原生支持HTTP/1 与 HTTP/2内置 ORM、WebSocket、HttpClient 等模块让你用接近脚本语言的开发速度快速搭建 CRUD 类 Web 应用。本文将带你完整走完Paozhu C 开发环境搭建全流程在Linux、macOS、Windows 三平台上使用CMake、xmake、vcpkg三套构建工具编译并首次运行 Paozhu全程照做即可在 30 分钟内跑起你的第一个 C Web 服务。一、开发环境准备编译器与依赖清单在动手之前先了解 Paozhu 的环境要求。框架强制要求C20标准编译脚本 CMakeLists.txt 中明确设置了CMAKE_CXX_STANDARD 20因此编译器建议平台推荐编译器LinuxGCC 11 或 Clang 14macOSApple ClangXcode Command Line ToolsWindowsMSVCVisual Studio 2022Paozhu 的第三方依赖不多核心只有 5 个见 vcpkg.json 的依赖声明asio网络 IO 与协程支持头文件库项目内已附带OpenSSLHTTPS 与多域名 SSL 支持MySQL 客户端库libmysqlclient/libmariadb内置 ORM 的数据库驱动zlibgzip 压缩brotlibr 压缩支持静态文件压缩缓存到磁盘 可选依赖gd qrencode生成二维码、图片处理、boost协程增强新手初装可跳过后续再按需开启。二、获取 Paozhu 源码并解压 Asio第一步克隆框架源码到本地git clone https://gitcode.com/gh_mirrors/pa/paozhu cd paozhuPaozhu 在 Linux/macOS 下默认使用独立版StandaloneAsio项目根目录自带了asio.zip解压后应形成如下目录结构paozhu/ ├── vendor/ ├── CMakeLists.txt └── asio/ ├── asio/ └── asio.hpp这一步非常关键CMake 脚本会优先查找项目内的 asio 目录如果asio.hpp找不到配置阶段会直接报错Standalone Asio not found。三、Linux 环境配置Ubuntu / FedoraUbuntu 20.04 或 Fedora 38 下用系统包管理器一次性装齐依赖sudo apt-get install cmake sudo apt-get install -y brotli libbrotli-dev zlib1g-dev sudo apt-get install openssl libssl-dev sudo apt-get install mysql-server mysql-common mysql-client libmysqlclient-dev # 可选二维码与图片处理 sudo apt-get install libgd-dev sudo apt-get install qrencode libqrencode-devFedora 用户注意两点需要 GCC 11 以上才能完整支持 C20Debug 模式启用了 AddressSanitizer需额外安装sudo yum install libasan。四、macOS 环境配置Homebrew 一键安装macOS 要求Big Sur及以上版本借助 Homebrew 安装命令最简洁brew install asio brew install mysql brew install mysql-client brew install zlib brew install brotli # 可选安装 brew install gd brew install qrencodeCMake 脚本对 Apple Silicon/opt/homebrew和 Intel/usr/local两种 Homebrew 路径都做了自动探测无需手动指定前缀。五、Windows 环境配置vcpkg 与 xmake 双路线Windows 是 Paozhu 较新支持的平台提供两条构建路线可按喜好任选其一。路线 Avcpkg CMake适合喜欢 CMake 的同学安装 vcpkg 并初始化项目清单模式项目自带vcpkg.json与vcpkg-configuration.json声明了 asio、openssl、libmariadb、brotli、zlib 依赖及 boost、gd 两个可选 feature解压项目根目录的asio.zip执行配置与编译-DENABLE_WIN_VCPKGON -DENABLE_VCPKGON开启 vcpkg 模式并用-DCMAKE_TOOLCHAIN_FILE指向 vcpkg 的vcpkg.cmakecmake . -B build -DENABLE_WIN_VCPKGON -DENABLE_VCPKGON ^ -DCMAKE_TOOLCHAIN_FILEvcpkg目录/scripts/buildsystems/vcpkg.cmake ^ -DVCPKG_TARGET_TRIPLETx64-windows -DCMAKE_BUILD_TYPEDebug -G Ninja cmake --build build --config Debug路线 BxmakeWindows 下更省事Paozhu 的 xmake.lua 已声明好add_requires(openssl,asio,zlib,brotli)等依赖xmake 会自动下载并链接所需包在项目根目录直接执行xmake编译产物位于build\windows\x64\release\或 debug 目录直接运行paozhu.exe即可。Windows 下如需本地 MySQL 库可下载 MySQL 8.0 的 winx64 包把其中的include、lib复制到项目根目录xmake 会自动识别并链接mysqlclient。六、三平台通用配置 server.conf 并首次编译编译前先修改配置文件conf/server.conf把其中所有/Users/hzq/paozhu前缀替换为你的实际项目目录如modelspath、viewpath、serverpath等字段这是新手最容易漏掉的一步。然后执行标准 CMake 构建流程mkdir build cd build cmake .. make # Debug 模式默认开启 ASan 与调试符号生产环境建议以 Release 模式编译-O3优化 守护进程模式cmake .. -DCMAKE_BUILD_TYPERelease make -j8使用 xmake 的同学则一条命令搞定 debug/release 切换xmake -m debug # 或 xmake -m release七、hosts 域名配置与启动服务Paozhu 支持多域名站点默认主域名取自server.conf中的mainhost如www.869869.com。在系统 hosts 文件中添加映射即可本地访问sudo vim /etc/hosts # 添加一行 127.0.0.1 www.869869.com启动服务Linux/macOS 下 80/443 端口需要 root 权限sudo ./bin/paozhu浏览器打开http://localhost看到 Paozhu 版本页说明环境搭建成功访问http://localhost/paozhu_version还能看到版本信息。框架还内置了一个完整的admin 后台管理框架访问/admin/main即可进入文章、栏目、站点管理等 CRUD 演示页面源码示例集中在controller目录新手可以直接参考。八、常见问题快速排查FAQ现象原因与解决Standalone Asio not found未解压项目根目录的asio.zip按第二节操作即可Could NOT find MySQL library未安装 MySQL 客户端开发库Linux 装libmysqlclient-devmacOS 装mysql-clientC20 编译报错编译器版本过低Linux 需升级到 GCC 11Debug 链接报 asan 相关错误Fedora 需安装libasanWindows Debug 需从 VS 安装目录复制clang_rt.asan_dynamic-x86_64.dll到可执行文件旁启动后 404 / 静态文件异常server.conf中的路径没有替换成自己的项目目录环境就绪后你可以继续体验 Paozhu 的高并发性能HTTP/2 下 h2load、ab、webbench 压测表现稳定与注解式路由开发模式//urlpath(null,hello) std::string testhello(std::shared_ptrhttppeer peer) { httppeer client peer-get_peer(); client Hello world! Paozhu c web framework ; return ; }把这个函数放入controller/src目录即可映射到/hello路由——这就是 Paozhu 注解 微型对象 的开发体验。总结回顾一下 Paozhu C 开发环境搭建的核心步骤准备 C20 编译器 → 克隆源码并解压 asio.zip → 按平台安装 asio/OpenSSL/MySQL/zlib/brotli 依赖apt、brew 或 vcpkg/xmake 自动管理→ 修改 server.conf 路径 → CMake 或 xmake 编译 → 配置 hosts 并启动bin/paozhu。三平台流程高度一致跟随本文操作你也能快速拥有自己的 C Web 开发环境接下来就可以上手编写 CRUD 业务了。【免费下载链接】paozhuPaozhu C Web Framework,(Based on C20) Support HTTP/1 HTTP/2, Rapid development of CRUD web applications, Include modules HttpServer HttpClient WebSocket ORM项目地址: https://gitcode.com/gh_mirrors/pa/paozhu创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考