怎么把 Python 安装路径改到 D 盘?

周末不加班
周末不加班
发布时间:2026-11-21 | 5人浏览过
原创

详细讲解在Windows系统中如何把Python安装路径更改到D盘,涵盖新安装自定义路径、已装C盘安全迁移、环境变量PATH校对以及避坑与验证全流程。

Windows 环境配置 · 实用指南

把 Python 安装路径改到 D 盘,核心是通过官方安装程序的自定义安装(Customize installation)重新指定目标文件夹,并配置对应的系统环境变量;如果是已经在 C 盘运行的环境,则不能直接复制剪切文件夹,而应导出依赖清单后重新安装至 D 盘。本文将详细拆解具体操作步骤与避坑细节。

怎么把 Python 安装路径改到 D 盘?

一、为什么不能直接把 C 盘的 Python 文件夹剪切到 D 盘?

许多用户为了清理系统盘空间,第一反应往往是直接打开文件资源管理器,将 C:\Users\<用户名>\AppData\Local\Programs\Python 整个文件夹“剪切”并“粘贴”到 D 盘。这种直接挪动文件夹的操作必然会导致 Python 环境崩溃。

Python 在 Windows 系统中并非纯粹的绿色免安装程序,安装时会在底层建立起紧密的引用依赖网络。一旦强行平移文件夹,将直接破坏以下三项核心机制:

  • Scripts 脚本的绝对路径硬编码(Shebang 机制):通过 pip 安装的控制台程序(例如 pip.exe、pytest.exe、uvicorn.exe)以及内部的启动脚本,在生成时都会把当前 Python 解释器的完整绝对路径写入可执行文件头部。强行移动目录后运行 pip,会立即抛出 Fatal error in launcher: Unable to create process using '"C:\...' 错误。
  • 系统与用户环境变量(PATH)失效:系统在终端响应 python 命令时,是按照环境变量中的声明路径逐一查找的。如果目录被挪走,PATH 仍指向失效的 C 盘原址,命令行就会提示“无法将 python 项识别为 cmdlet、函数、脚本文件”。
  • Windows 注册表与关联项断链:Python 官方安装包会在注册表 HKEY_CURRENT_USER\Software\Python\PythonCore 或本地机配置中写入安装基准路径。诸如 VS Code、PyCharm、Python Launcher(py.exe)以及 C++ 扩展包编译工具等,都会依据注册表定位动态链接库(DLLs),直接移动会导致这些开发工具全面丢失解释器。
怎么把 Python 安装路径改到 D 盘?
图 1:直接剪切平移导致的三层系统依赖与硬编码断裂示意图

二、标准做法:全新安装或重装至 D 盘的具体步骤

将 Python 部署在 D 盘最稳妥、最干净的做法是在安装向导中进行自定义配置。即使电脑中已有装在 C 盘的旧版本,也建议按后文说明先卸载原程序,再按以下标准步骤重新安装。

1. 规划好 D 盘目标目录规范

在安装前,请在 D 盘建立一个结构明晰的纯英文目录。路径规划应当遵循两个重要原则:

  • 严禁包含中文字符与空格:不要将路径设为 D:\我的软件\Python 或 D:\Program Files\Python。许多底层 C/C++ 编写的 Python 扩展库(如 numpy、scipy)在读取带有中文或空格的路径时会出现编译失败或找不到 DLL 的异常。
  • 建议按版本细分目录:推荐建立 D:\Python\Python312\ 这类层级结构,后续如果需要并行安装 Python 3.10 或 3.11,可以规范并列存放。

2. 启动安装程序并选择“Customize installation”

双击从官网下载的 python-3.x.x-amd64.exe 离线安装包。在打开的初始安装窗口中:

  1. 务必勾选底部选项:先勾选 Add python.exe to PATH(将 Python 添加至环境变量)。
  2. 点击自定义安装:切勿直接点击上方大号字体的 Install Now(这会直接装进 C 盘个人目录),必须点击下方的 Customize installation(自定义安装)。

3. 确认可选特性(Optional Features)

点击进入下一步后,向导会展示“可选特性”列表。建议保持全部默认勾选状态,重点确保 Documentation、pip、tcl/tk and IDLE 以及 Python test suite 处于选中状态。点击 Next 继续。

4. 配置高级选项并修改目标盘符

进入“Advanced Options”(高级选项)页面,这是更改盘符的关键一步:

  1. 勾选 Install Python for all users:勾选此项可以让 Python 作为系统全局运行时生效,同时安装包会自动把默认目录从深层 AppData 切换为系统标准根目录。
  2. 修改 Customize install location 输入框:将其中的路径修改为你预先规划好的 D 盘路径,例如 D:\Python\Python312。
  3. 点击 Install,系统弹出 UAC 提权提示后点击“是”,等待安装进度完成。
怎么把 Python 安装路径改到 D 盘?
图 2:Python 官方安装向导四大核心操作与路径定制流程

三、情况二:已经安装在 C 盘,如何安全迁移到 D 盘?

如果你已经在 C 盘使用了较长时间的 Python,且安装了许多第三方库,为了避免重装后丢失已有的开发依赖,应采用“先导出清单、再卸载重装、后恢复依赖”的标准迁移流程:

1. 导出已安装的第三方库清单

在进行任何卸载操作之前,打开当前系统自带的命令行(PowerShell 或 CMD),执行以下命令将当前所有第三方库名称及精确版本导出到文本文件中:

# 导出当前 C 盘环境的依赖包清单到本地文本文件
pip freeze > D:\requirements.txt

该命令会在 D 盘生成一个 requirements.txt 文本,记录了所有通过 pip 安装的库(如 requests、pandas 等)。

2. 卸载 C 盘旧环境并清理残留

打开 Windows「设置」→「应用」→「已安装的应用」,在搜索框中输入 Python:

  • 找到对应的 Python 核心主程序(例如 Python 3.12.2 (64-bit)),点击右侧选项菜单并选择卸载。
  • 卸载完毕后,手动检查原目录 C:\Users\<用户名>\AppData\Local\Programs\Python,如果残留未被卸载脚本清理的第三方缓存,可手动将其彻底删除以释放 C 盘空间。

3. 按前述流程全新安装至 D 盘

运行安装包,按照本文第二节的步骤将目标路径指定为 D:\Python\Python312 并完成安装。

4. 批量重新恢复第三方库

打开新终端,确认当前 pip 已指向 D 盘后,执行一键恢复命令:

# 在新 D 盘环境中批量安装原有的全部依赖
pip install -r D:\requirements.txt
补充技巧:转移 pip 的全局下载缓存目录

很多用户之所以将 Python 迁往 D 盘,是因为 C 盘容量吃紧。然而即使将 Python 主体装在 D 盘,后续使用 pip 下载轮子包(wheels)时,默认缓存仍然会存放在 C:\Users\<用户名>\AppData\Local\pip\cache。如果希望彻底解放 C 盘,可以在命令行执行以下命令,将 pip 缓存同步改到 D 盘:

pip config set global.cache-dir "D:\Python\pip-cache"

四、配置与核对系统环境变量(PATH)

安装完成后,命令行能够直接通过输入 python 和 pip 唤醒程序的前提,是系统环境变量 PATH 中已正确收录对应目录。即使安装时勾选了相关选项,也建议按以下步骤进行二次复核。

1. 进入环境变量配置界面

  1. 按下键盘快捷键 Win + R,在运行窗口中输入 sysdm.cpl 并回车打开“系统属性”。
  2. 切换至「高级」选项卡,点击右下方的「环境变量」按钮。
  3. 在下方的“系统变量”(或上方的“用户变量”)中找到名为 Path 的条目,双击打开编辑界面。

2. 必须包含的两个核心路径

在编辑环境变量窗口中,必须确保列表中存在以下两条指向 D 盘的条目(根据你的实际版本和文件夹名称调整):

配置项路径示例 承载作用 缺少该项的表现
D:\Python\Python312\ 存放 python.exe 主解释器及核心动态链接库 终端输入 python 提示无法识别命令
D:\Python\Python312\Scripts\ 存放 pip.exe 及所有第三方命令行工具可执行文件 可以运行 python,但终端输入 pip 会报错
怎么把 Python 安装路径改到 D 盘?
图 3:Windows 环境变量 PATH 双路径配置要求与组件职能对应图

避坑细节:Windows 默认内置了一个位于 Microsoft\WindowsApps 的 python.exe(大小仅 0KB,其实是一个跳转到微软应用商店安装页面的占位程序)。如果终端中输入 python 意外弹出了微软应用商店,说明环境变量顺序不对,或者别名冲突。只需在环境变量窗口中选中 D 盘的两条路径,点击右侧的「上移」,将它们置于 WindowsApps 之前即可;或者在 Windows 设置的“应用执行别名”中关闭“应用安装程序 (python.exe)”开关。

五、安装结果检验与故障排除

安装与环境变量调整完成后,必须重新启动一个新的终端窗口(已打开的终端无法感知新环境变量的变更),执行以下验证步骤。

1. 验证 Python 解释器与实际加载路径

在命令行中依次输入:

# 检查版本号
python --version
# 示例输出:Python 3.12.2

# 检查当前 python 可执行文件的物理绝对路径
where python
# 示例输出:
# D:\Python\Python312\python.exe
# C:\Users\<用户名>\AppData\Local\Microsoft\WindowsApps\python.exe

标准判断依据:where python 会按照优先级从上到下列出所有同名可执行文件。首行必须明确显示为 D:\Python\Python312\python.exe。如果第一行仍为 C 盘路径或 WindowsApps 路径,说明环境变量配置有误或未上移。

2. 验证包管理器 pip 是否正常就绪

# 检查 pip 识别情况与绑定的 Python 版本
pip --version
# 示例输出:
# pip 24.0 from D:\Python\Python312\Lib\site-packages\pip (python 3.12)

注意看末尾括弧内的路径与信息,必须指向 D 盘。如果此处出现前文提及的 Fatal error in launcher,说明系统残存了旧的 pip 脚本,可通过执行 python -m pip install --upgrade --force-reinstall pip 强制在新目录下重构启动程序。

怎么把 Python 安装路径改到 D 盘?
图 4:D 盘 Python 环境终检决策树与常见报错闭环排查图

总结

将 Python 安装路径改到 D 盘,核心准则是“通过自定义安装重新规划,绝不直接物理剪切”。只要牢记在安装界面勾选 Add python.exe to PATH、点击 Customize installation、指定纯英文且无空格的 D 盘路径,并在安装后通过 where python 和 pip --version 确认生效,就能既节省宝贵的系统盘空间,又获得一个稳定、高效的 Python 运行环境。

相关专题:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表