uni-halo + 微信小程序开发实录：我的第一个作品诞生记

这篇文章介绍了使用uni-halo框架进行微信小程序开发的过程，包括选择该框架的原因、开发目标以及项目配置和部署的步骤。

本文作者 白雾茫茫丶
文章发布日期 2025-07-01 14:03
热度 112
本文共计
预计阅读

前言

作为一个独立开发者（或技术爱好者），我在选择微信小程序开发框架时，主要考虑了以下几个因素：

开发效率：
- 我不想从零开始搭建项目，希望有一个开箱即用的解决方案，快速实现想法。
- uni-halo 基于 Vue.js，语法友好，学习曲线平缓，适合个人快速迭代。
- 配置方便，可在 Halo 控制台配置相关信息
跨平台能力：
- 虽然目前目标是微信小程序，但未来可能会扩展到其他平台（如H5、App）。
- uni-halo 的跨端编译能力，让代码复用成为可能，减少后续适配成本。
轻量化和社区支持：
- 相比完整版 uni-app，uni-halo 更轻量，适合个人项目，避免冗余配置。
- 尽管生态不如原生微信开发完善，但足够满足基础需求，且社区教程逐渐增多。

最终目标：用最低的学习成本，快速上线一个功能完整、界面美观的个人小程序！

关于 uni-halo

uni-halo 是一个基于 Halo 2.x 提供的 API 接口，开发的一套开源的博客应用。

完全免费开源，包括程序源码、插件源码
页面支持插件配置
使用最新流行的技术栈
支持特色功能，恋爱日记
支持编译为：小程序（推荐）、 APP、 H5

uni-halo 项目依赖于 Halo 2.x 版本程序的项目 API 接口，如果您没有使用 Halo 2.x 或者使用的是其他的博客程序，您无需再继续往下看

环境准备

DCloud 账号（该账号用于登录 HBuilder X 开发工具和编译 uni-halo 项目）

https://dev.dcloud.net.cn/

微信小程序账号（该账号用于发布和上线微信小程序）

https://mp.weixin.qq.com/

推荐 Node.js 版本：14/16/18

https://nodejs.org/zh-cn

HBuilderX（官方IDE，支持 uni-halo 开发，用于将 uni-halo 编译或上传到 微信小程序开发工具）

https://www.dcloud.io/hbuilderx.html

微信开发者工具（用于调试和发布 uni-halo 小程序到微信开放平台上线发布）

https://developers.weixin.qq.com/miniprogram/dev/devtools/stable.html

运行项目

克隆源码

git clone https://github.com/ialley-workshop-open/uni-halo.git

打开开发工具 HBuilder X 工具，点击左上角 文件-导入-从本地导入 ，找到下载好的 uni-halo 源码
修改配置，配置是一个非常重要的步骤，在配置完成后，才能正常使用小程序，配置分为源码配置和插件配置。
- 源码配置：在 uni-halo 源码的 config 目录中，找到 token.config.json 文件，按照提示进行配置。
- 插件配置：在 Halo 后台的 插件管理 中，找到 UniHalo配置 插件，按照提示进行配置。

先将仓库 fork 到自己的仓库中，然后再 clone 到本地，使用 main 分支。

uni-halo 配置

生成 Token

登录后台，点击左下角的用户头像，进入个人中心选择 我的-个人令牌，新建令牌，如图：

2. Token 配置

在项目根目录下找到 token.config.template.js 修改为 token.config.js 文件：

import {getAppConfigs} from "@/config/index";

/** 配置博客的内容 */
const UniHaloConfig = Object.freeze({

	/** 基础请求域名：你的Halo博客基础域名 */
	BASE_API: "https://baiwumm.com",
    /** Halo 插件后台配置 */
	systemToken: getAppConfigs()?.basicConfig?.tokenConfig?.personalToken,
})

export default UniHaloConfig;