From 56100dd32e9727199100d15d13048b592e94469e Mon Sep 17 00:00:00 2001
From: Cong Zhang <13283869+congzhangzh@users.noreply.github.com>
Date: Thu, 4 Apr 2024 07:48:55 +0800
Subject: [PATCH] doc: add tips about vcpkg cause build faild on windows
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

PR-URL: https://github.com/nodejs/node/pull/52181
Refs: https://github.com/nodejs/help/issues/1656
Reviewed-By: Vinícius Lourenço Claro Cardoso <contact@viniciusl.com.br>
---
 BUILDING.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/BUILDING.md b/BUILDING.md
index 0f9807509ac5f9..4f6462b8d5b7e8 100644
--- a/BUILDING.md
+++ b/BUILDING.md
@@ -590,6 +590,22 @@ to run it again before invoking `make -j4`.
 
 ### Windows
 
+#### Tips
+
+You may need disable vcpkg integration if you got link error about symbol
+redefine related to zlib.lib(zlib1.dll), even you never install it by hand,
+as vcpkg is part of CLion and Visual Studio now.
+
+```powershell
+# find your vcpkg
+# double check vcpkg install the related file
+vcpkg owns zlib.lib
+vcpkg owns zlib1.dll
+vcpkg integrate remove
+```
+
+Refs: #24448, <https://github.com/microsoft/vcpkg/issues/37518>, [vcpkg](https://github.com/microsoft/vcpkg/)
+
 #### Prerequisites
 
 ##### Option 1: Manual install