先确认是长路径问题：复制报错完整路径到资源管理器打不开，或PowerShell中Get-Item报“260”字样即坐实；注册表LongPathsEnabled=1需配合Python≥3.8、pip≥21.3及PowerShell运行才生效；临时方案为设$env:TEMP="C:\tmp"并加--no-cache-dir；长期应控制Python安装路径、虚拟环境及项目名深度。
pip install 报 OSError: [WinError 206] 怎么确认是长路径问题
先别急着改注册表。直接复制报错里出现的完整路径（比如 C:\Users\Alice\AppData\Local\Temp\pip-install-abc123\volcengine_python_sdk-1.2.3\src\volcengine\auth\signer\v4\__init__.py），粘贴进资源管理器地址栏——打不开且提示“路径不存在”或“太长”，基本就是它。再用 PowerShell 运行：Get-Item "你的完整路径"，若报错含 Cannot find path 和 260 字样，就坐实了。
注册表 LongPathsEnabled=1 为什么改了还是失败
只改注册表 ≠ 解决问题。必须同时满足三项，缺一不可：
-
LongPathsEnabled值为 1，且在HKEY_LOCAL_MACHINE\SYSTEM\ControlSet00X\Control\FileSystem下（不是软链接CurrentControlSet；先查HKEY_LOCAL_MACHINE\SYSTEM\Select\Current看实际编号） - Python 版本 ≥ 3.6（推荐 ≥ 3.8），旧版即使注册表开了也无效
- pip 进程必须由支持长路径的 Python 启动：检查你用的是不是 conda 自带的旧 Python（如 3.5），或 PyCharm/VS Code 是否用了嵌入式解释器
验证是否真正生效：python -c "import os; print(os.path.supports_long_paths)" 输出 True 才算到位。
临时绕过：5 分钟内让 pip 装上包
不用重启、不改注册表，立刻见效：
立即学习“Python免费学习笔记（深入）”；
- 在 C 盘根目录新建空文件夹：
C:\tmp - PowerShell 中执行：
$env:TEMP="C:\tmp"; $env:TMP="C:\tmp"（当前终端生效） - 加
--no-cache-dir避免缓存路径也超长：pip install volcengine-python-sdk --no-cache-dir
原理是把 pip 解压临时目录从默认的 %LOCALAPPDATA%\Temp 挪到极短路径下，腾出空间给包自身嵌套结构。
长期开发必须控制安装路径深度
很多问题其实在第一步就埋下了：
- 重装 Python 时，安装路径选
C:\Python312，**绝不**用C:\Users\YourName\AppData\Local\Programs\Python\Python312 - 虚拟环境创建也别嵌套太深：
python -m venv C:\venv\myproj比C:\Users\...\Desktop\...\venv安全得多 - 项目文件夹名尽量短，避免中文和空格；
my_project_v2_final_revised这种命名在长路径场景下就是隐形炸弹
真正麻烦的不是改一次注册表，而是所有路径操作——包括 os.path.join()、Path().resolve()、甚至 IDE 的自动补全——都可能在某一层悄悄越界。一旦漏掉一个环节，OSError: [WinError 206] 就会准时出现。
