diff --git a/README.md b/README.md
index 94fae3e7..223a4b67 100644
--- a/README.md
+++ b/README.md
@@ -189,6 +189,20 @@ PKGBUILD, desktop entry, release sync, and optional **local-from-source** packag
 
 ## Build from source
 
+### Prerequisites
+
+**macOS:** Xcode Command Line Tools (`xcode-select --install`).
+
+**Linux (Ubuntu/Debian):**
+
+```bash
+sudo apt install build-essential cmake libx11-dev libxtst-dev libxrandr-dev libxt-dev
+```
+
+**Windows:** Visual Studio 2022 (or Build Tools) with the C++ workload and CMake.
+
+### Steps
+
 ```bash
 git clone https://github.com/webadderall/Recordly.git recordly
 cd recordly
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 6a2d0486..18e166fa 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -185,6 +185,20 @@ PKGBUILD、桌面入口、发布同步，以及可选的**本地源码打包**
 
 ## 从源码构建
 
+### 前置依赖
+
+**macOS：** 安装 Xcode Command Line Tools（`xcode-select --install`）。
+
+**Linux（Ubuntu / Debian）：**
+
+```bash
+sudo apt install build-essential cmake libx11-dev libxtst-dev libxrandr-dev libxt-dev
+```
+
+**Windows：** 安装 Visual Studio 2022（或 Build Tools），并勾选 C++ 工作负载和 CMake。
+
+### 构建步骤
+
 ```bash
 git clone https://github.com/webadderall/Recordly.git recordly
 cd recordly