直接在项目根目录新建.gitignore文件即可,需确保位于Git仓库根目录、写入正确规则(如node_modules/),并用git rm -r --cached清除已跟踪文件缓存。

直接在项目根目录新建 .gitignore 文件就行
VS Code 本身不提供“Git 忽略向导”,但创建 .gitignore 是纯文件操作,不需要插件或额外配置。关键不是“怎么建”,而是“建在哪”和“建完要不要立刻生效”。它必须放在 Git 仓库的根目录(即运行过 git init 或已关联远程仓库的那个文件夹),否则 Git 完全不会读取。
touch .gitignore 是最快建法,但 Windows 用户得换命令
在 VS Code 集成终端(Ctrl+`)里执行:
- macOS / Linux:直接运行
touch .gitignore - Windows PowerShell:用
ni .gitignore(ni是New-Item的别名) - Windows CMD:用
type nul > .gitignore
别用资源管理器右键 → 新建文本文档再改名——容易残留 .txt 扩展名,导致文件实际叫 .gitignore.txt,Git 不认。
建完空文件没用,得写规则,且注意路径写法
常见错误是写错斜杠或漏掉通配符。比如想忽略所有 node_modules 目录,必须写成:
node_modules/
而不是 node_modules(不带斜杠会匹配文件名含该字符串的任意文件)或 /node_modules/(开头斜杠表示只匹配项目根下的,子目录里的就漏了)。其他高频规则:
- Python:
__pycache__/、*.pyc、.venv/ - 通用编辑器:
.vscode/、.DS_Store、Thumbs.db - 构建产物:
dist/、build/、out/
已经 git add 过的文件,加进 .gitignore 也无效
这是最常被卡住的点:.gitignore 只对「从未被 Git 跟踪」的文件起作用。如果之前执行过 git add node_modules 或 git add .,现在加规则也没用。验证方式:git ls-files --cached | grep node_modules,有输出就说明还在缓存里。解决办法只有一步:
git rm -r --cached node_modules
注意必须带 --cached,否则本地文件真会被删。执行后 git status 会显示它变成 “deleted”,这时再 git commit -m "stop tracking node_modules" 才算真正生效。
规则写对、位置放对、历史缓存清干净——三者缺一不可。尤其第三点,很多人反复修改 .gitignore 却发现文件还在待提交列表,问题八成出在这儿。


















