Vscode如何设置Git忽略文件？Vscode版本控制过滤配置-VSCode-PHP中文网

Vscode如何设置Git忽略文件？Vscode版本控制过滤配置

穿越時空

发布： 2025-06-26 16:37:02

原创

746人浏览过

在vscode中使用git时，设置.gitignore文件可排除不需要版本控制的文件或文件夹。1. 创建.gitignore文件：位于项目根目录或.git文件夹同级目录；2. 编辑.gitignore文件：每行写入忽略规则；3. 忽略特定文件：直接写文件名如my_secret_file.txt；4. 忽略特定文件夹：加斜杠如node_modules/；5. 使用通配符：匹配多字符，?匹配单字符如.log、temp?；6. 反向忽略：用!符号保留特定文件如!/my_folder/important_file.txt；7. 检查状态：用git status确认忽略效果；8. 清理缓存：已追踪文件需执行git rm -r --cached .后重新提交；9. 全局设置：创建.gitignore_global文件并配置core.excludesfile参数；10. 常见问题：文件已被追踪、位置错误、规则书写错误、缓存问题、全局配置异常；11. vscode插件支持：自动读取.gitignore隐藏忽略文件，并提供扩展辅助管理。

Vscode如何设置Git忽略文件？Vscode版本控制过滤配置

通常，在Vscode中使用Git时，我们需要设置.gitignore文件来排除不需要版本控制的文件或文件夹，避免不必要的文件被提交到代码仓库。这有助于保持代码仓库的整洁，提高工作效率。

解决方案：

创建.gitignore文件： 在你的项目根目录下创建一个名为.gitignore的文件（注意文件名以点开头）。如果你的项目已经存在Git仓库，确保.gitignore文件位于.git文件夹的同级目录。
编辑.gitignore文件： 使用Vscode或其他文本编辑器打开.gitignore文件，并在其中添加你想要忽略的文件或文件夹的规则。每行一个规则。
- 忽略特定文件： 直接写入文件名，例如：my_secret_file.txt
- 忽略特定文件夹： 写入文件夹名称，例如：node_modules/ （注意最后的斜杠，表示这是一个文件夹）
- 使用通配符： 可以使用*来匹配多个字符，使用?匹配单个字符。例如：*.log 忽略所有.log文件， temp? 忽略temp1, temp2等文件。
- 忽略特定类型文件： 例如：*.pyc 忽略所有Python编译文件。
- 反向忽略： 如果想要忽略某个文件夹下的所有文件，但保留其中的一个特定文件，可以先忽略整个文件夹，然后使用!符号来反向忽略该文件。例如：
```
/my_folder/*
!/my_folder/important_file.txt
```
  登录后复制
  这会忽略my_folder下的所有文件，但会保留important_file.txt。

示例.gitignore文件内容：

# OS generated files
.DS_Store
Thumbs.db

# Node.js
node_modules/
dist/
npm-debug.log*
yarn-debug.log*
yarn-error.log*

# Python
*.pyc
__pycache__/

# VS Code
.vscode/

# Compiled source #
######################
*.com
*.class
*.dll
*.exe
*.o
*.so

# Logs and databases #
######################
*.log
*.sql
*.sqlite
*.db

# Packages #
############
# it's better to unpack these files and commit the raw source
# git has its own built in compression methods
*.7z
*.dmg
*.gz
*.iso
*.jar
*.rar
*.tar
*.zip

# OS generated files #
######################
.DS_Store
Thumbs.db

登录后复制

检查Git状态： 在终端中使用git status命令，查看哪些文件被Git忽略。确认你想要忽略的文件确实没有被追踪。
清理Git缓存（如果需要）： 如果某些你想要忽略的文件之前已经被添加到Git仓库，你需要先将它们从缓存中移除。可以使用以下命令：
```
git rm -r --cached .
git add .
git commit -m "Remove cached files"
```
登录后复制
这个命令会移除所有已缓存的文件，然后重新添加所有未被忽略的文件。注意，这个操作会删除本地文件，如果不想删除，请备份。

如何全局设置.gitignore？

有时候，我们希望某些文件（例如操作系统生成的文件，或者IDE的配置文件）在所有Git项目中都被忽略。这时，可以设置全局的.gitignore文件。

创建全局.gitignore文件： 在你的用户目录下创建一个文件，命名为.gitignore_global（或者你喜欢的名字）。
编辑全局.gitignore文件： 在文件中添加你想要全局忽略的规则，格式与项目中的.gitignore文件相同。
配置Git使用全局.gitignore文件： 在终端中执行以下命令：
```
git config --global core.excludesfile ~/.gitignore_global
```
登录后复制
这个命令会告诉Git使用你创建的.gitignore_global文件作为全局忽略规则。注意，~符号代表你的用户目录。

为什么.gitignore文件有时不生效？

.gitignore文件不生效通常是因为以下几个原因：

文件已经被Git追踪： 如果文件在添加到.gitignore之前就已经被Git追踪，.gitignore的规则不会生效。需要先将文件从Git缓存中移除，然后重新添加。参考上面的“清理Git缓存”步骤。
.gitignore文件位置错误： .gitignore文件必须位于项目的根目录，或者要忽略的文件夹的父目录中。
规则书写错误： .gitignore的规则书写错误，例如拼写错误，或者使用了错误的通配符。仔细检查规则是否正确。
缓存问题： 有时候Git的缓存会导致.gitignore不生效。可以尝试清除Git的缓存：
```
git rm -r --cached .
git add .
git commit -m "Fix .gitignore"
```
登录后复制
全局.gitignore设置问题： 如果使用了全局.gitignore文件，检查全局配置文件是否正确设置。