diff --git a/.gitignore b/.gitignore
index 06e0520..6104594 100644
--- a/.gitignore
+++ b/.gitignore
@@ -8,6 +8,7 @@ vendor/
 
 # VitePress 文档站构建产物与缓存
 docs/.vitepress/dist/
+docs/.vitepress/dist*/
 docs/.vitepress/cache/
 docs/.vitepress/config.mjs.timestamp-*.mjs
 .DS_Store
diff --git a/docs/.vitepress/config.mjs b/docs/.vitepress/config.mjs
index b550655..9e4bdfb 100644
--- a/docs/.vitepress/config.mjs
+++ b/docs/.vitepress/config.mjs
@@ -3,9 +3,13 @@ import { defineConfig } from 'vitepress'
 // 部署到子路径时，构建前设置环境变量即可：
 //   DOCS_BASE=/ny-exam-docs/ npm run docs:build
 const base = process.env.DOCS_BASE || '/'
+// 输出目录。默认 .vitepress/dist；若需要保留旧产物（或环境禁止删除目录），
+// 可用 DOCS_OUT=.vitepress/dist2 npm run docs:build 输出到新目录。
+const outDir = process.env.DOCS_OUT || '.vitepress/dist'
 
 export default defineConfig({
   base,
+  outDir,
   lang: 'zh-CN',
   title: 'NY 问卷考试系统数据平台',
   description: '基于 PHP 8 + 卷王（SurveyKing）社区版开放 API 的零依赖考试数据统计平台',