Z-Blog 有两个主要版本，它们的源码和技术栈完全不同。

1. Z-BlogPHP (旧版，现已停止核心更新): 基于 PHP + MySQL 技术栈。
2. Z-Blog 12 (新版，目前主推版本): 基于 .NET (C#) + SQLite 技术栈。

当你寻找“Z-Blog 网站源码”时，你需要确定是哪一个版本，下面我将分别对这两个版本的源码进行详细说明。

Z-Blog 12 (.NET 版) 源码

这是目前官方主推的、正在积极开发的版本，如果你要研究或二次开发，应该重点关注这个。

核心技术栈

• 后端: .NET 6.0 / .NET 8.0 (C#): 使用微软的现代 .NET 框架，性能优异，类型安全。
• 数据库: SQLite: 一个轻量级、文件型的数据库，优点是无需单独安装和配置数据库服务，部署极其简单（一个 .db 文件搞定所有数据），对于个人博客和小型网站来说非常理想。
• 前端: Razor Pages / Blazor: 主要使用 Razor Pages 作为服务器端渲染技术，部分功能可能使用 Blazor 进行交互。
• UI 框架: Bootstrap 5: 提供响应式布局和美观的后台管理界面。
• 模板引擎: Razor Engine: 用于将 C# 代码和 HTML 模板结合，动态生成网页。
• 构建工具: SDK-Style Projects: 使用 dotnet 命令行工具进行构建、发布和管理依赖。

源码结构概览 (以 Z-Blog 12 为例)

当你下载并解压 Z-Blog 12 的源码后，你会看到类似下面的主要目录结构：

Z-Blog/
├── .github/               # GitHub Actions 相关配置文件
├── src/                   # **核心源码目录**
│   ├── ZBlog.AspNetCore/  # Z-Blog 的核心类库
│   │   └── (C# 源码文件, *.cs)
│   ├── ZBlog.Web/         # Web 应用程序入口
│   │   ├── Pages/         # Razor Pages 页面模型
│   │   ├── wwwroot/       # 静态资源 (CSS, JS, 图片)
│   │   ├── appsettings.json # 应用配置文件
│   │   └── Program.cs     # 应用程序启动入口
│   └── ZBlog.sln          # Visual Studio 解决方案文件
├── templates/             # **主题模板目录**
│   └── default/           # 默认主题
│       ├── 51la/          # 统计代码等
│       ├── bower_components/ # 前端依赖
│       ├── css/           # 主题样式
│       ├── js/            # 主题脚本
│       ├── inc/           # 主题公共组件 (头部、底部等)
│       └── zblogphp/      # (历史遗留，新版已不用)
│           └── ...
├── apps/                  # **插件目录**
│   └── ...
├── 2FA/                   # 两步验证相关文件
├── cache/                 # 系统缓存目录
├── config/                # 系统配置文件目录
├── data/                  # **数据库文件目录**
│   └── zblog.db           # SQLite 数据库文件
├── index.php              # 入口文件 (PHP 版本的遗留，新版已用 index.html)
├── index.html             # 静态入口文件
├── license.txt            # 开源协议
└── ...

核心文件解读

• src/ZBlog.Web/Program.cs: 这是整个网站的启动文件，配置了依赖注入、中间件（如 MVC、静态文件、路由等）。
• src/ZBlog.AspNetCore/: 这是 Z-Blog 的“心脏”，包含了所有核心业务逻辑，如文章管理、评论系统、用户系统、主题系统等。
• templates/: 这是前端开发者最常接触的地方，默认主题的结构非常清晰，inc/ 文件夹包含了 _partial.html (头部、侧边栏、底部等)，post-single.html 是文章页模板，index.html 是首页模板，你通过修改这些 HTML 和 CSS/JS 文件来定制网站外观。
• apps/: 插件系统，每个插件都是一个独立的文件夹，包含自己的配置文件、模板文件和逻辑代码。
• data/zblog.db: 所有网站数据（文章、评论、分类、用户设置等）都存储在这个 SQLite 文件中，你可以使用任何 SQLite 客户端（如 DB Browser for SQLite）来直接查看和操作数据。

如何获取和运行源码？

• 获取源码:

  
  （图片来源网络，侵删）
  1. GitHub: 官方源码托管在 GitHub 上，你可以直接克隆仓库：git clone https://github.com/zblogcn/zblogphp.git (注意，虽然仓库名是 zblogphp，但里面是 Z-Blog 12 的 .NET 源码)。
  2. 官网下载: 访问 Z-Blog 官网，下载最新版本的 Z-Blog 12，解压后即可看到源码。

• 运行源码 (开发环境):

  1. 安装环境: 确保你的电脑上安装了 .NET 6.0 SDK 或 .NET 8.0 SDK。
  2. 打开项目: 使用 Visual Studio 2025 或 VS Code 打开 src/ZBlog.sln 解决方案文件。
  3. 还原依赖: 在 IDE 中会自动执行 dotnet restore 命令，下载所需的 NuGet 包。
  4. 运行项目: 按下 F5 或点击“开始调试”按钮，Visual Studio 会自动启动一个 Kestrel 服务器，并在浏览器中打开你的 Z-Blog 网站。

Z-BlogPHP (旧版) 源码

这是一个经典的开源博客系统,虽然核心功能已停止更新，但仍有大量网站在使用，并且有丰富的主题和插件生态。

核心技术栈

• 后端: PHP: 传统的 PHP 编程，没有使用现代框架（如 Laravel, Symfony），而是采用了类似“框架”的自研结构。
• 数据库: MySQL: 需要一个独立的 MySQL 数据库来存储数据。
• 前端: 原生 JavaScript + jQuery: 大量使用 jQuery 来处理前端的交互。
• 模板引擎: 自定义模板引擎: 使用 {$xxx} 这样的语法来输出变量，通过 template/ 目录下的文件来定义页面结构。

源码结构概览

Z-BlogPHP/
├── 2fa/                   # 两步验证
├── cache/                 # 系统缓存
├── css/                   # 样式文件
├── data/                  # 数据库配置文件 (zb_users)
├── images/                # 图片资源
├── include/               # **核心函数库和类库**
│   ├── c_pdo_mysql.php    # MySQL 数据库操作类
│   ├── functions.php      # 全局函数库
│   └── ...                # 其他核心功能模块
├── phpmailer/             # 邮件发送组件
├── template/              # **主题目录**
│   └── default/           # 默认主题
│       ├── css/           # 主题样式
│       ├── js/            # 主题脚本
│       ├── bower_components/ # 前端依赖
│       └── *.php          # 模板文件 (index.php, single.php 等)
├── admin/                 # **后台管理目录**
│   └── *.php              # 后台功能页面
├── xmlrpc/                # XML-RPC 接口
├── index.php              # **网站前台入口文件**
├── default.php            # 默认首页重定向
├── function/c_html.php    # HTML 处理函数
└── ...

核心文件解读

• index.php: 这是所有前台流量的入口，它会加载必要的配置文件和类库，然后根据 URL 参数（如 id=123 表示文章ID）来调用相应的模板文件（如 post-single.php）并输出最终的 HTML。
• include/ 目录: 这是 Z-BlogPHP 的“引擎库”，里面包含了数据库操作、用户验证、文章处理、评论处理等所有核心功能的 PHP 类和函数。
• template/default/ 目录: 和 Z-Blog 12 类似，这里是主题的天下。.php 文件混合了 HTML 和 PHP 代码，用来动态生成页面。
• admin/ 目录: 后台管理系统的所有功能都在这里，每个功能通常对应一个 .php 文件。
• data/zb_users.php: 这个文件非常关键！它不仅存储了数据库的连接信息，还存储了网站的全局配置（如网站名称、URL等）和用户信息。在部署时务必修改其默认内容以提高安全性。

如何获取和运行源码？

• 获取源码:

  1. GitHub: git clone https://github.com/zblogcn/zblogphp.git
  2. 官网下载: 访问 Z-Blog 官网，下载 Z-BlogPHP 的最新稳定版。

• 运行源码:

  1. 安装环境: 需要一个支持 PHP (>=7.2) 和 MySQL 的 Web 服务器环境，如 LAMP (Linux+Apache+MySQL+PHP) 或 LNMP (Linux+Nginx+MySQL+PHP)，XAMPP、WAMP 等集成开发环境也可以。
  2. 部署: 将源码上传到 Web 服务器的根目录（如 htdocs 或 www）。
  3. 安装: 通过浏览器访问你的域名，按照安装向导进行操作，主要是配置数据库信息。
  4. 完成: 安装成功后，你就可以访问前台和后台了。

总结与对比

给你的建议：

• 如果你想学习最新的技术、追求极致的性能和最简单的部署方式，请选择 Z-Blog 12，并研究其 .NET 源码。
• 如果你正在维护一个老旧的 Z-BlogPHP 网站，或者想快速上手一个基于 PHP 的博客系统，请选择 Z-BlogPHP，并研究其 PHP 源码。

希望这份详细的解读能帮助你理解 Z-Blog 的源码结构！