diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..321c2bf
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,67 @@
+# ========== macOS 系统文件 ==========
+.DS_Store
+.AppleDouble
+.LSOverride
+._*
+.Spotlight-V100
+.Trashes
+Icon?
+
+# ========== 编辑器 / IDE ==========
+.vscode/
+.idea/
+*.iml
+*.swp
+*.swo
+*~
+.history/
+
+# ========== Node.js / 前端 ==========
+node_modules/
+dist/
+build/
+out/
+.next/
+.nuxt/
+.turbo/
+.cache/
+coverage/
+.pnpm-store/
+*.tsbuildinfo
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# ========== Python ==========
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+venv/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.ipynb_checkpoints/
+
+# ========== 环境变量 / 本地配置 ==========
+.env
+.env.local
+.env.*.local
+
+# ========== 日志与临时文件 ==========
+*.log
+logs/
+tmp/
+temp/
+*.tmp
+*.bak
+*.orig
+
+# ========== Office / 文档临时文件 ==========
+~$*
+*.~lock.*
+
+# ========== 项目自定义 ==========
+# 参考项目：仅本地参照，不纳入版本控制、不推送到远程仓库
+参考项目/