这篇文章介绍了使用uni-halo框架进行微信小程序开发的过程,包括选择该框架的原因、开发目标以及项目配置和部署的步骤。
前言
作为一个独立开发者(或技术爱好者),我在选择微信小程序开发框架时,主要考虑了以下几个因素:
开发效率:
我不想从零开始搭建项目,希望有一个开箱即用的解决方案,快速实现想法。
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项目)
开发者中心
微信小程序账号(该账号用于发布和上线微信小程序)
微信公众平台
微信公众平台,给个人、企业和组织提供业务服务与用户管理能力的全新服务平台。
HBuilderX(官方IDE,支持 uni-halo 开发,用于将
uni-halo编译或上传到微信小程序开发工具)
https://www.dcloud.io/hbuilderx.html
HBuilderX-高效极客技巧
HBuilderX是当前最快的HTML开发工具,强大的代码助手帮你快速完成开发,最全的语法库和浏览器兼容性数据让浏览器碎片化不再头痛
微信开发者工具(用于调试和发布
uni-halo小程序到微信开放平台上线发布)
https://developers.weixin.qq.com/miniprogram/dev/devtools/stable.html
微信开发者工具(稳定版 Stable Build)下载地址与更新日志 | 微信开放文档
推荐
Node.js版本:14/16/18
Node.js — Run JavaScript Everywhere
运行项目
克隆源码
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;插件配置

UniHalo 的具体配置,可以去插件中查看!