Free tools Windows power users keep installed
One-click scans. No signup required.
If a path was already tracked by Git, adding it to .gitignore will not make it disappear from Git’s changes. Keep the local file and remove its index entry with git rm --cached <path>; then commit that change. If the path is untracked, use git check-ignore -v to find which rule is affecting it.
First, check whether Git already tracks the path
Ignore rules are for keeping files that Git does not track from being tracked. They do not untrack a file that is already in the repository index. The Git project describes this as the purpose of ignore files in its gitignore manual.
Check the path’s state with git status --short -- <path>. A tracked file that has been modified may appear as a change; a newly added or staged file may also be tracked even if it has not yet been committed. In either case, the ignore rule alone is not the remedy.
Stop tracking a file without deleting your local copy
For a tracked file you want to keep on your computer but remove from the repository, add the appropriate ignore rule, then run:
#1 Best Overall
git rm --cached -- path/to/fileThe --cached option removes the file from Git’s index while leaving the working-tree copy in place. Review the staged change with git status, then commit it so the repository records the removal. The Git project documents this remedy in its git rm manual.
For a tracked directory, use the same approach with a recursive removal:
Rank #2
git rm -r --cached -- path/to/directoryUse the exact path you intend to untrack. The change affects the index and will be shared with others when committed; collaborators who update their checkout may see the tracked files removed there, even though your local copies remain where you ran the command.
For an untracked path, find the rule Git is applying
Run:
git check-ignore -v -- path/to/fileFor a path subject to ignore rules, verbose output identifies the rule’s source, line number, pattern, and pathname. A pattern beginning with ! is a negation: it can undo an earlier exclusion, so a matching negation means the path is not ignored. See the git check-ignore manual.
By default, git check-ignore omits paths already tracked by Git because ignore rules do not apply to them. To inspect which pattern would match a tracked path anyway, use:
git check-ignore --no-index -v -- path/to/fileThis diagnostic does not change the index or untrack the file.
Check rule location, precedence, and path scope
Ignore rules may come from more than the root .gitignore. Git considers command-line patterns, applicable .gitignore files in the path’s directory and its parent directories, repository-level excludes in .git/info/exclude, and the file configured through core.excludesFile. A lower-level .gitignore can override a higher-level one; among patterns at the same level, the last matching pattern determines the result. The gitignore manual describes these sources and precedence rules.
- To share a project rule: put it in a repository
.gitignoreand commit that file. - For a rule only in your clone: use
.git/info/exclude. - For a personal rule across repositories: use the configured global excludes file.
Pattern scope depends on its placement and syntax. A pattern with a slash is relative to the directory containing that .gitignore. For example, /build/ in the repository-root file matches a root-level directory named build; *.log is a broader wildcard pattern. These are illustrations, not universal defaults—choose a pattern that fits the path you mean to ignore.
Do these 3 things before closing this tab:
1Clear out junk files and repair common Windows errors2Fix the driver behind crashes, sound loss and screen glitches3Repair Windows errors before they cause bigger problemsBest Value
Understand exceptions and excluded parent directories
A negated pattern can re-include a path excluded by an earlier rule, but Git cannot re-include a file while one of its parent directories remains excluded. If you exclude a directory and then add !child, the exception may not work because Git does not traverse the excluded parent to reach that child.
The manual demonstrates a pattern structure for excluding most root-level contents while allowing a nested path:
/*
!/foo
/foo/*
!/foo/barAdapt the structure to your repository’s actual paths and directory layout; do not copy it blindly.
Quick Recap
A quick troubleshooting order
- Check whether Git already tracks the path. If it does, add the intended ignore rule and use
git rm --cached -- <path>(orgit rm -r --cached -- <directory>). - If it is untracked, run
git check-ignore -v -- <path>to locate the matching rule. - If no expected rule appears, inspect the path spelling and its location relative to the relevant
.gitignore; then check nested ignore files,.git/info/exclude, and the configured global excludes file. - Check for a later matching pattern or a negation that cancels the exclusion. If the parent directory is excluded, make it traversable before trying to re-include a child.
- After changing the rule, confirm the result with
git status --short. If the file was tracked, remember that the index removal must be committed to change what the repository tracks.
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
