本文总结一些 VSCode 使用过程中遇到的问题和解决方案
VSCode 不显示 Git 修改情况
- VSCode 不显示 Git 修改情况（比如行号旁的颜色标记、文件状态图标、源代码管理面板无内容等），通常是 Git 配置、工作区设置或插件冲突 导致的
第一步：基础检查：确认项目已关联 Git 仓库
- VSCode 仅对 Git 仓库目录 显示修改跟踪，先确认项目是否初始化 Git
- 执行命令
git status
第二步：启用 VSCode 内置 Git 功能（核心步骤）
- VSCode 内置 Git 支持，可能被手动禁用，需重新启用：
- 1）打开 VSCode 设置
- 2）搜索配置项
git.enabled，确保勾选（值为true） - 3）搜索配置项
git.decorations.enabled，确保勾选（控制行号旁的修改标记、文件图标状态） - 4）重启 VSCode（关键！修改配置后需重启生效）
第三步：检查 Git 可执行文件路径（Git 未被 VSCode 识别）
- 若 VSCode 找不到 Git 程序，会无法跟踪修改，需手动指定 Git 路径
- 先确认本地已安装 Git（终端执行
git --version，若提示“不是内部命令”，需先安装） - 在 VSCode 设置中搜索/创建
git.path- 注意，这个字段可能找不到，需要在
settings.json文件中手动加入 - 比如添加
"git.path": "/usr/bin/git"- Windows：默认
C:\Program Files\Git\bin\git.exe或C:\Program Files\Git\cmd\git.exe；- Mac/Linux：默认
/usr/bin/git或/usr/local/bin/git（可通过which git命令查询）；
- Mac/Linux：默认
- Windows：默认
- 注意，这个字段可能找不到，需要在
- 重启 VSCode，再查看是否生效
其他可能的问题
- Git 版本过低：VSCode 对旧版 Git 兼容性较差，升级 Git 到 2.20+ 版本（官网下载最新版）；
- 权限问题：项目目录或
.git文件夹无读写权限- Windows 右键目录 -> 属性 -> 安全 -> 允许“完全控制”；
- Mac/Linux 执行
chmod -R 755 项目目录；
- VSCode 版本过旧：升级 VSCode 到最新版（左下角齿轮 -> 检查更新）
- 冲突插件或 VSCode Git 配置错误
附录：修复文件/文件夹的 Git 跟踪状态（仅部分文件不生效时）
- 若部分文件不显示修改，可能是 Git 未跟踪或被忽略
- 检查
.gitignore文件：确保目标文件没有被添加到.gitignore（比如node_modules/、dist/等目录会被默认忽略，修改这些目录的文件不会显示跟踪）； - 手动跟踪未跟踪文件：终端执行
git add 文件名（或git add .跟踪所有文件），之后修改文件会显示红色（删除）、绿色（新增）、黄色（修改）标记； - 清除 Git 缓存（若文件曾被
.gitignore忽略后需重新跟踪）1
2
3
4
5git rm --cached 文件名 # 单个文件
# 或所有文件
git rm -r --cached .
git add .
git commit -m "修复 Git 跟踪状态"
快捷键修改
- File -> Preferences -> Keyboard Shortcuts
- 可按照快捷键或名字搜索即可
- 名称：
- 如 前进/后退（中文）或 go back / go forward 表示前进或后退
- 如 缩进/减少缩进 或 indent / outdent 表示缩进或者减少缩进
- 快捷键：
- 如 ctrl, cmd, tab, space，shift 等
- 名称：