git filter-repo调用提示找不到Python，已安装Python3.9仍报错

各终端提示Python was not found的对应遗漏点 #

已安装Python 3.9但终端识别不到，基本是以下配置没有完成：

• 安装Python时未勾选「Add Python to PATH」选项
  Windows版Python安装包默认不会自动把可执行路径加到系统环境变量，没勾选这个选项的话，哪怕Python程序装在本地，所有终端都无法直接调用python、pip命令。
• 手动补配环境变量时路径遗漏
  不需要重装Python，只需要把两个Python相关路径手动加入系统环境变量的Path列表：
  • Python安装根目录（默认路径类似C:\Users\你的用户名\AppData\Local\Programs\Python\Python39）
  • 根目录下的Scripts子目录（默认路径类似C:\Users\你的用户名\AppData\Local\Programs\Python\Python39\Scripts）
• 改完环境变量后没有重启终端
  Windows的终端窗口只会在启动时加载一次环境变量，改完Path之后如果不关掉重开，所有终端还是会沿用旧的环境配置，提示找不到Python是正常现象。
  配置完成后可以在任意终端执行python --version，能正常返回Python 3.9.x的版本信息，就说明Python这部分配置达标了。

Git Bash提示git: 'filter-repo' is not a git command的对应遗漏点 #

要明确一个核心前提：git filter-repo不是Git的原生内置命令，哪怕Python环境配置完全正确，没有单独安装这个工具本身，Git永远不会识别这个子命令。常见的漏装/配错情况包括：

• 没有通过pip安装git filter-repo本身
  在Python环境正常生效的终端里，执行pip install git-filter-repo才能完成工具安装，很多用户以为这个是Git自带功能，跳过了安装步骤。
• pip安装完成后路径未对齐
  Git识别自定义子命令的规则是，只要系统可执行路径中存在名为git-xxx格式的程序，执行git xxx时Git就会自动关联调用。只要前面配好的Python Scripts目录在系统Path里，pip安装生成的git-filter-repo可执行文件就会被Git自动识别，不需要手动把文件拷贝到Git的安装目录下。

最终验证流程 #

• 关掉所有已经打开的终端窗口，重新启动Git Bash、Powershell、CMD，确保最新的环境变量全部加载
• 在任意路径下执行git filter-repo --version，能正常返回工具版本号就说明配置打通
• 进入需要清理大文件的Git仓库目录，执行原命令git filter-repo --strip-blobs-bigger-than 100M即可正常运行

内容的提问来源于stack exchange，提问作者spsuk