diff --git a/.vscodeignore b/.vscodeignore
index 3c24e14..12af979 100644
--- a/.vscodeignore
+++ b/.vscodeignore
@@ -16,6 +16,9 @@ out/test/**
 # 依赖
 node_modules/**
 
+# 文档（避免中文文件名打包问题）
+docs/**
+
 # 只排除 waveform_trace 的 src/dist 目录
 tools/waveform_trace/src/dist/**