[Bug]: pip install litellm still exceeds Windows MAX_PATH under Microsoft Store Python

快速结论：当 Windows 未启用长路径支持、且使用 Microsoft Store 版 Python 时，pip install litellm 会因安装包内过长路径超过 Windows MAX_PATH 而失败；优先确认是否为 Store Python 及其深层 site-packages 路径，并尝试升级到包含相关修复的 LiteLLM 版本。

适用环境：Windows；Microsoft Store 安装的 Python 3.12；未启用 Windows 长路径支持（默认关闭）；LiteLLM v1.103.1；通过 pip / Python SDK 安装。

最快修复方案：Issue 中未给出已由提交者亲自验证的一步修复方案；维护者提到修复已在 #43903 中提交。可优先尝试安装包含该修复的 LiteLLM 版本，或临时采用不依赖 LiteLLM 的方案。

注意事项：报错路径长度来自 v1.103.1 源码树，Issue 作者并未在本地 Windows 复现该问题。启用 Windows 长路径支持、更换 Python 安装方式或排除特定文件夹均属于可能有效但未在本 Issue 中确认的缓解方式。

问题场景

用户在 Windows 上使用 Microsoft Store 安装的 Python 3.12，通过 pip install litellm 安装 LiteLLM Python SDK。由于 Windows 长路径支持默认关闭，而 Store Python 的用户级 site-packages 路径本身已很深，包内较长的文件路径会使最终路径超过 MAX_PATH 限制，导致安装失败。

报错原文

ERROR: Could not install packages due to an OSError: [Errno 2] No such file or directory

失败路径位于 litellm_content_filter 相关目录。Issue 中给出的最长打包路径示例为：

litellm/proxy/guardrails/guardrail_hooks/litellm_content_filter/guardrail_benchmarks/evals/block_disability_discrimination.jsonl

原因分析

可能原因是 Windows 默认未启用长路径，而 Microsoft Store 版 Python 的用户级 site-packages 前缀较长。Issue 指出该前缀为 134 个字符再加上用户名，例如：

C:\Users\<user>\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.12_qbz5n2kfra8p0\LocalCache\local-packages\Python312\site-packages\

LiteLLM v1.103.1 中最长的打包路径为 128 个字符，因此对于任意用户名，完整路径都会超过 259 个字符，从而触发 Windows MAX_PATH 限制。此前 #29597 的修复仅覆盖约 100 字符的 site-packages 前缀，未覆盖 Store Python 这类更深的路径。

环境排查

确认操作系统为 Windows，且是否已启用长路径支持；Issue 场景中该支持为默认关闭。
确认 Python 是否为 Microsoft Store 安装的 Python 3.12。
确认 LiteLLM 版本是否为 v1.103.1（Issue 报告版本）。
确认失败路径是否位于 litellm_content_filter 或 guardrail_benchmarks 下。
确认用户名长度以及实际 site-packages 前缀长度，未在 Issue 中确认的项目无需额外推断。

解决步骤

先确认当前环境与报错路径是否与上述 Store Python 深层 site-packages 场景一致。
维护者表示修复已在 #43903 中提交，可优先尝试安装包含该修复的 LiteLLM 版本，而不是继续使用 v1.103.1。
如果安装失败主要影响成本计算功能，Issue 评论中提到的一种临时做法是从依赖中移除 LiteLLM，改用 genai-prices 处理 cost-per-token 需求；这是特定用户的替代方案，不是官方一步修复。
如果仍需继续使用当前版本，可评估是否启用 Windows 长路径支持或改用非 Store 版 Python，以缩短 site-packages 路径；但 Issue 中未验证这些做法能解决该问题。

验证方法

在目标 Windows 环境中重新执行 pip install litellm，确认不再出现 OSError: [Errno 2] No such file or directory，并且安装过程不再因 litellm_content_filter 相关路径过长而中断。若使用替代方案，则确认相关依赖不再需要安装 LiteLLM 即可满足原有功能。