Manus v2.0 Mac Node.js 快速搭建个人博客全攻略

在macOS环境中搭建个人博客站点，技术门槛并不高，但细节若遗漏就会卡壳。Manus v2.0 的部署链路本身很直白，前提是底层的运行时依赖必须一次配准。

举例来说，要用 Manus v2.0 在本地拉起博客服务，Node.js 运行时环境是刚性前提。缺少 Node，Manus 服务进程根本无法启动，后续的依赖解析、脚本执行、服务绑定都会中断在第一环。正确做法不是急着拉源码，而是先确认 Mac 中是否已安装 Node.js 及其版本是否合规。

打开终端，执行两条命令即可快速验证：

node -v
npm -v

若输出类似v20.15.1和10.7.0的版本号——注意 Node.js 需 ≥ 18.0，npm 需 ≥ 9.0——说明环境达标，可以继续。如果返回command not found，请暂停所有操作，优先完成 Node.js 安装。

【硬性门槛：Node.js 版本不得低于 18.0，否则 Manus v2.0 的 ESM 模块加载会直接抛出异常——亲身踩过的坑。】

确认 Mac 系统已安装 Node.js 并验证版本

打开终端，依次执行以下两条命令：

node -v → npm -v

若均返回类似 v20.15.1 和 10.7.0 的版本号（Node.js ≥ 18.0，npm ≥ 9.0），说明环境可用；若提示 command not found，请立即停止后续操作，先完成 Node.js 安装。

【必须满足：Node.js 版本不能低于 18.0，否则 Manus v2.0 的 ESM 模块加载会失败】

下载并解压 Manus v2.0 源码包

前往官方 GitHub Releases 页面（https://github.com/manus-ai/manus/releases），找到标注 v2.0.0 或更高 patch 版本的 Assets，下载 manus-v2.0.x-macos-arm64.tar.gz（Apple Silicon 芯片）或 manus-v2.0.x-macos-x64.tar.gz（Intel 芯片）。

双击解压到任意目录，例如 ~/Documents/manus-blog；避免放在 iCloud Drive 或 Dropbox 同步文件夹内，否则 Node 进程可能因文件锁异常退出。

初始化 Manus 项目并启动本地服务

第一步：进入解压后的根目录

cd ~/Documents/manus-blog

第二步：安装生产依赖（使用 npm，不推荐 cnpm 或 yarn，Manus v2.0 的 package-lock.json 仅适配 npm 10+）

npm install --omit=dev

第三步：复制默认配置模板

cp config/config.example.toml config/config.toml

第四步：启动开发服务器

npm run dev

终端输出包含 Local: http://localhost:3000 即表示成功；此时在 Safari 或 Chrome 中打开该地址，即可看到 Manus 默认博客首页。

补充一个实操细节：依赖安装阶段务必使用 npm，别换成 cnpm 或 yarn——Manus v2.0 的 package-lock.json 只与 npm 10 及以上版本兼容，换包管理器大概率导致锁定文件冲突。复制配置文件的步骤也不能跳过，否则 Manus 会因缺失默认配置而报错。最后启动服务后，终端显现 Local: http://localhost:3000 即代表一切就绪，直接浏览器访问该地址就能看到 Manus 默认的博客首页。