必须忽略 node_modules/、dist/、.env.local、.idea/、.vscode/、vite/、.log 等核心目录和文件，防止敏感信息泄露与协作冲突；推荐用 /dist/、*/.env.local 等标准语法，并通过 git rm -r --cached . 清缓存确保生效。
Vue 3 项目初始化时，.gitignore 要优先配置好，否则容易把本地环境、依赖、编辑器文件等误提交，影响协作和安全。
必须忽略的核心目录和文件
这些内容绝不能进 Git，应直接写入 .gitignore：
-
node_modules/：依赖包体积大、平台相关，靠
pnpm install或npm install重装即可 -
dist/：构建产物，由 CI 或本地
pnpm build生成，每次打包都不同 -
.env.local：仅限你本地的密钥、测试接口地址等敏感信息，必须忽略（注意：
.env、.env.prod等公共环境文件建议提交） - .idea/、.vscode/：IDE 配置因人而异，统一用全局 .gitignore 或项目级忽略
- .vite/：Vite 运行时缓存，自动生成，无需版本控制
- *.log、npm-debug.log、pnpm-debug.log：运行或安装过程产生的日志文件
推荐的通用规则写法
避免漏掉子目录或拼写错误，用标准语法提高可维护性：
- 以
/开头表示从项目根目录匹配，如/dist/只忽略根下的 dist，不干扰子目录同名文件夹 - 用
**/匹配任意层级，比如**/.env.local更保险（虽然通常只在根下） - 注释用
#开头，方便后续维护，例如：# Local environment files - 如果某类文件要部分保留，可用
!取反，比如!.env.example确保示例模板被提交
配置后常见问题处理
刚加完 .gitignore 常遇到“不生效”，多数是因为文件已被 Git 跟踪过：
立即学习“前端免费学习笔记（深入）”；
- 执行
git rm -r --cached .清空当前索引缓存 - 再运行
git add .重新添加未被忽略的文件 - 最后
git commit -m "chore: update .gitignore" - 验证是否生效：用
git status --ignored查看哪些被正确忽略
进阶建议：搭配全局忽略更省心
有些文件（如 .DS_Store、*.swp）在所有项目里都不该提交，可设为全局忽略：
- 运行
git config --global core.excludesfile ~/.gitignore_global - 然后在
~/.gitignore_global中写入通用规则，比如：.DS_Store<br>*.swp<br>*.swo
- 这样新建任何 Git 仓库都会自动应用，不用每个项目重复配置
