diff --git a/.gitignore b/.gitignore
index b1a59569..6141ca49 100644
--- a/.gitignore
+++ b/.gitignore
@@ -48,6 +48,8 @@ Thumbs.db
 *.md
 !README.md
 !CLAUDE.md
-!docs/**/*.md
+
+# 忽略 docs 目录（开发文档不提交到 Git）
+docs/
 
 src/assets/img/original-backup/