准备工作
这里将介绍部署前需要准备的工作：账号、开发环境和源码。
1. 准备账号
1.1 说明
根据前置说明，需要准备以下账号：
- 微信小程序账号：用于小程序的部署和上线
- DCloud 开发者账号：仅在打包 APP 时需要
- 地图服务商账号：仅在使用「足迹地图」时需要，腾讯位置服务或高德开放平台二选一
1.2 注册微信小程序账号
访问 https://mp.weixin.qq.com 进行注册，填写所需资料即可。
⚠️ 主体类型提醒
博客/资讯类小程序不建议使用个人主体注册：个人主体无法选择资讯类目，存在被微信平台下架或封禁的风险，建议使用企业或个体工商户主体。详见 部署须知 - 重要提醒。
1.3 注册 DCloud 开发者账号
访问 https://dev.dcloud.net.cn/ 进行注册，打包 APP 时使用。
1.4 注册地图服务商账号（使用足迹地图时）
「足迹地图」依赖 uni-app 的 <map> 组件，需要地图服务商的 Key 才能渲染：
Key 切勿提交到公开仓库
申请到的 Key 必须写在不会被 Git 追踪的 env/.env.local，并且严禁提交到公开仓库，否则会被他人盗刷导致付费超额甚至账号被风控。申请流程与配置方式见 应用配置 - 地图 Key 配置。
只发布微信小程序则无需申请：小程序端的 <map> 底图由微信提供，不用配置任何 Key。
2. 开发环境
uni-halo v3.x 基于 unibest 脚手架，全程命令行开发，无需 HBuilderX。需要安装：
- Node.js（>= 20）
- pnpm（>= 9）
- 微信开发者工具（发布小程序用）
2.1 安装 Node.js
如果本地已有 Node.js 环境（node -v 输出 >= 20），可以跳过。
下载地址：https://nodejs.org/zh-cn/download
2.2 安装 pnpm
npm install -g pnpm2.3 安装微信开发者工具
访问 https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html 下载安装即可。
提示
微信开发者工具中需要开启「设置 - 安全设置 - 服务端口」，以便命令行工具能够自动拉起开发者工具。
3. 准备源码
3.1 下载源码
git clone https://github.com/uni-halo/uni-halo.gitgit clone https://gitee.com/uni-halo/uni-halo.git也可以直接下载 发布版压缩包。
3.2 安装依赖
进入项目目录，使用 pnpm 安装依赖（项目强制使用 pnpm）：
cd uni-halo
pnpm install4. 准备 Halo 站点
uni-halo 依赖 Halo 站点提供的数据与接口，部署前请确保：
- 已部署 Halo 2.x 站点（版本 ≥ 2.26），可参考 Halo 官方文档；
- 站点域名已完成备案并支持
https访问； - 已安装并启用
UniHalo 配置插件（核心插件），具体见 插件配置； - 按需安装并启用评论组件、搜索组件、链接管理、图库管理、瞬间、投票管理、数据看板等插件，对应功能才会可用，清单见 插件配置 - 安装插件。
5. 修改配置
uni-halo v3.x 的配置分为两部分：
其中微信小程序 AppID 需要在微信小程序后台「设置 - 基本设置 - 账号信息」中查看，填写到 env/.env 的 VITE_WX_APPID 中。
若需要使用「足迹地图」，还需按 应用配置 - 地图 Key 配置 在 env/.env.local 中填写地图 Key。
贡献者
小莫唐尼