导读最近在尝试安装SkillHub时遇到了一系列典型的 Windows 环境配置问题。由于我使用的是目前非常流行的 Python 包管理器uv而非传统的系统级 Python 安装导致在执行安装脚本时终端频频报错提示找不到 Python 或 python3。这篇文章记录了从环境变量冲突、应用执行别名干扰到手动配置python3别名的完整排查过程。如果你也在 Windows 下使用uv或遇到了类似的“Python not found”问题希望这篇教程能帮你节省时间。⚠️ 初次尝试Python 找不到最开始我直接复制了官方提供的安装命令运行结果终端立刻抛出了错误$ curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash Python was not found; run without arguments to install from the Microsoft Store, or disable this shortcut from Settings Apps Advanced app settings App execution aliases.这是因为我的开发环境主要由uv管理并没有将 Python 添加到全局 PATH 中。验证一下PS C:\Users\Azrng python -v Python was not found; run without arguments to install from the Microsoft Store, or disable this shortcut from Settings Apps Advanced app settings - App execution aliases. 环境分析uv 的目录结构先来看看当前的系统环境变量PATH配置情况D:\Soft\pyuv C:\Users\Azrng\AppData\Local\Microsoft\WindowsApps D:\Program Files\Microsoft VS Code\bin可以看到uv的目录D:\Soft\pyuv已经在环境变量中了。确认一下uv的安装是否正常PS C:\Users\Azrng uv --version uv 0.9.8 (85c5d3228 2025-11-07)在这个目录下只有uv的可执行文件并没有直接的python.exePS D:\Soft\pyuv dir 目录: D:\Soft\pyuv Mode LastWriteTime Length Name ---- ------------- ------ ---- -a---- 2025/11/7 18:05 60600832 uv.exe -a---- 2025/11/7 18:05 330752 uvw.exe -a---- 2025/11/7 18:05 330752 uvx.exe我们需要找到uv实际管理的 Python 解释器在哪里。使用以下命令查看PS C:\Users\Azrng uv python list cpython-3.13.9-windows-x86_64-none AppData\Roaming\uv\python\cpython-3.13.9-windows-x86_64-none\python.exe️ 解决方案一修正环境变量优先级既然找到了 Python 的真实路径我们就可以尝试将这个路径加入环境变量。操作步骤1. 在系统环境变量PATH中新增一项C:\Users\Azrng\AppData\Roaming\uv\python\cpython-3.13.9-windows-x86_64-none2.关键点将这一项移动到C:\Users\Azrng\AppData\Local\Microsoft\WindowsApps之前。这样做是为了优先找到真实的 Python而不是 Windows 应用商店的快捷方式。修改后打开一个新的 PowerShell 窗口验证PS C:\Users\Azrng python --version Python 3.13.9很好PowerShell 中已经能识别 Python 了。但此时如果我们在Git BashMINGW64中再次尝试安装问题依旧AzrngAZRNG MINGW64 /d $ curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash Python was not found; run without arguments to install from the Microsoft Store, or disable this shortcut from Settings Apps Advanced app settings - App execution aliases.️ 解决方案二禁用 App Execution AliasesWindows 系统有一个“应用执行别名”功能它会拦截python.exe的调用。为了彻底避免干扰建议将其关闭。操作步骤1. 打开Windows 设置→应用→高级应用设置→应用执行别名。2. 找到python.exe和python3.exe将开关关闭。img 解决方案三解决python3依赖问题关掉别名后再次运行安装脚本虽然不再提示之前错误了但出现了新的错误AzrngAZRNG MINGW64 /d/Soft/pyuv $ curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash Error: python3 is required for skillhub. AzrngAZRNG MINGW64 /d/Soft/pyuv $ where python3 信息: 用提供的模式无法找到文件。 AzrngAZRNG MINGW64 /d/Soft/pyuv $ where python C:\Users\Azrng\AppData\Roaming\uv\python\cpython-3.13.9-windows-x86_64-none\python.exe问题分析脚本明确要求python3命令但uv管理的目录下只有python.exe。系统找不到python3这个可执行文件。解决方法我们需要手动做一个“复制并重命名”的操作。进入uv的 Python 安装目录C:\Users\Azrng\AppData\Roaming\uv\python\cpython-3.13.9-windows-x86_64-none将python.exe复制一份并重命名为python3.exe。验证一下AzrngAZRNG MINGW64 /d/Soft/pyuv $ where python3 C:\Users\Azrng\AppData\Roaming\uv\python\cpython-3.13.9-windows-x86_64-none\python3.exe现在再次执行安装命令curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash这次脚本运行没有报错了但输入skillhub -v查看版本时又遇到一个坑AzrngAZRNG MINGW64 /d/Soft/pyuv $ skillhub -v bash: skillhub: command not found # 检查安装目录是否存在 ls -la /c/Users/Azrng/.local/bin/skillhub✅ 解决方案四添加 SkillHub 全局路径虽然安装成功但skillhub的可执行文件所在的目录还没有加入到环境变量中。操作步骤编辑用户环境变量在PATH中新增C:\Users\Azrng\.local\bin注意记得新开一个命令行窗口让环境变量生效。再次验证AzrngAZRNG MINGW64 ~/.local/bin $ skillhub -v skillhub 2026.3.18 AzrngAZRNG MINGW64 ~/.local/bin $ skillhub install github Downloading: https://lightmake.site/api/v1/download?sluggithub Installed: github - C:\Users\Azrng\.local\bin\skills\github完美技能安装成功 总结在 Windows 下使用uv这种非传统的 Python 管理工具时安装旧脚本或依赖python3命令的工具容易遇到环境变量冲突。回顾一下本次排错的 4 个关键点1.优先级问题确保真实 Python 路径在WindowsApps之前。2.系统拦截果断关闭 Windows 的App Execution Aliases。3.命令别名针对报错需求手动复制python.exe为python3.exe。4.工具路径别忘了将工具的 bin 目录如.local\bin加入 PATH。