# 错误：使用 file:// 路径的可编辑安装不支持 '--prefix' 选项。

- **ID:** `pip/editable-install-prefix-option-conflict`
- **领域:** pip
- **类别:** config_error
- **错误码:** `ERROR`
- **验证级别:** ai_generated
- **修复率:** 80%

## 根因

当包以 file:// URL 形式指定时，pip 的可编辑安装模式（pip install -e）无法接受自定义的 --prefix，因为安装路径逻辑与基于前缀的重定位冲突。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| pip 23.2 | active | — | — |
| pip 23.3 | active | — | — |
| pip 24.0 | active | — | — |

## 解决方案

1. ```
   使用相对路径或绝对路径，省略 file://，并避免使用 --prefix。示例：pip install -e /path/to/package
   ```
2. ```
   以非可编辑模式安装包并使用 --prefix：pip install file:///path/to/package --prefix /custom/prefix
   ```
3. ```
   在目标前缀位置设置虚拟环境并安装：python -m venv /custom/prefix && /custom/prefix/bin/pip install -e /path/to/package
   ```

## 无效尝试

- **** — PYTHONPATH overrides import order but does not create editable symlinks, so changes to source are not reflected. (60% 失败率)
- **** — Pip expects a package name, not a filesystem path, when file:// is omitted. (70% 失败率)