VS Code环境执行pip安装TensorFlow触发OS错误，找不到指定文件
2026-9-26
TensorFlow安装报错解决方案
报错根因
该报错本质是Windows系统下Python包安装路径层级超过限制触发的路径截断问题，即便开启了LongPathsEnabled，微软应用商店版本Python的默认存储路径嵌套过深也可能触发兼容异常。
可行解决方案
方案1：替换为官方版本Python（最推荐）
微软应用商店版Python的默认用户包存储路径嵌套层级极深，长路径兼容存在先天缺陷，优先替换解决：
- 卸载当前微软应用商店安装的Python 3.9：打开「设置>应用>安装的应用」，搜索Python，找到带有PythonSoftwareFoundation标识的3.9版本完成卸载
- 前往Python官网下载对应3.9版本的exe安装包，安装时勾选Add Python 3.9 to PATH，选择自定义安装，将安装路径设置为
C:\Python39这类层级极浅的目录 - 安装完成后打开终端，执行
python --version、pip --version验证安装正常后，重新执行安装命令即可
方案2：修改pip用户包安装路径（无需重装Python）
如果不想替换Python版本，可以修改pip的默认安装路径绕开深层嵌套目录：
- 在磁盘根目录新建文件夹，例如
C:\PyPackages - 打开系统环境变量设置，新增两个用户变量：
- 变量名
PYTHONUSERBASE，变量值填新建的路径C:\PyPackages - 编辑Path变量，新增条目
%PYTHONUSERBASE%\Scripts
- 变量名
- 保存所有环境变量修改后重启VS Code，重新执行
pip install tensorflow
方案3：虚拟环境安装
在浅层级路径下创建虚拟环境单独安装TensorFlow：
- 在磁盘根目录新建文件夹，例如
C:\TFEnv - 在该文件夹下打开终端，执行
python -m venv .创建虚拟环境 - 执行激活命令：
.\\Scripts\\activate，终端前缀出现(TFEnv)标识即为激活成功 - 激活状态下执行
pip install tensorflow即可
方案4：兜底精简安装
如果仅需核心功能，可以安装精简版本绕开冗余组件的深层路径问题：
- 不需要GPU支持的用户可以执行
pip install tensorflow-cpu，该版本体积更小，路径嵌套更少 - 也可以执行
pip install --no-deps tensorflow先安装核心包，再单独安装缺失的依赖组件
注意：修改LongPathsEnabled注册表项后必须重启整机才会生效，修改环境变量后至少要重启VS Code/终端才会生效。
内容的提问来源于stack exchange，提问作者Dragon Light
相关产品推荐
相关产品推荐
