从源代码构建

为了开发、测试或是定制化部署，在本地构建 Memos。

当你想要为 Memos 提交贡献、测试本地变更或是定制化开发时，从源代码构建是一个正确的路子。

先决条件

• Go 1.25+
• Node.js 22+
• pnpm 10+
• Git

典型流程

git clone https://github.com/usememos/memos.git
cd memos
cd web
pnpm install
pnpm release
cd ..
go build -o build/memos ./cmd/memos

运行：

./build/memos

Memos 默认会监听 http://localhost:8081。

构建过程做了什么

• 首先生成前端资源

• 然后构建后端的二进制文件

• 如果构建是面向发布的，前端资源将会嵌入二进制文件中

本地开发

通常的本地开发流程：

• 在本地运行后端程序：go run ./cmd/memos

• 如果有需要，则运行前端服务器。

• 除非有使用 MySQL 或 PostgreSQL 的需求，首先使用 SQLite

• 在提 PR 之前执行测试

何时需要从源码构建

• 你需要一个定制的版本或分支

• 你想要调试或分析 Memos 程序

• 你想要为代码或文档提交贡献

• 你希望嵌入另一个前端版本，这个前端与特定的后端更改相关联

在使用生产版本前

• 使用打了 tag 的或已固定的版本构建

• 为实例 URL 和数据库显示地设置环境变量

• 构建后执行冒烟测试

• 部署新的二进制文件之前保留备份