VSCode 安装与配置指南

Python 3.9.5 开发环境搭建 | Windows 10

1安装 Python 3.9.5

⚠ 关键注意：安装界面底部务必勾选 "Add Python to PATH"，否则 CMD 中无法使用 python 和 pip 命令。

安装步骤

（1）双击运行 Python 3.9.5 安装包

（2）在安装界面底部 勾选 "Add Python to PATH"

（3）点击 "Customize installation"，按默认选项全部勾选，点击 Next

（4）建议将安装路径修改为简洁路径，如 C:\Python39\，避免路径中包含中文或空格

（5）点击 Install，等待安装完成

验证安装

打开 CMD（Win + R → 输入 cmd → 回车），依次执行：

python --versionpip --version

✓ python --version 应输出 Python 3.9.5

✓ pip --version 应输出 pip 版本及安装路径

2升级 pip 并配置国内镜像源

2.1 升级 pip

Python 3.9.5 自带的 pip 版本较旧，建议安装完成后立即升级：

python -m pip install --upgrade pip -i https://mirrors.aliyun.com/pypi/simple/

2.2 配置国内镜像源（永久生效）

💡 推荐操作：配置后后续安装第三方库时自动走国内镜像，速度快且稳定。

pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/

常用国内镜像源：

3安装 VSCode

（1）双击运行 VSCode-x64-1.80.1 安装包

（2）安装选项中建议全部勾选（包括"添加到PATH"、"创建桌面快捷方式"等）

（3）选择安装路径，点击 安装，等待完成

（4）安装完成后 重启电脑（确保 PATH 环境变量生效）

📋 说明：安装路径同样建议避免中文和空格，推荐如 C:\VSCode\。

4汉化 VSCode

（1）打开 VSCode，点击左侧 扩展 图标（或按 Ctrl + Shift + X）

（2）在搜索框中输入 Chinese

（3）找到 "Chinese (Simplified) Language Pack"，点击 Install

（4）安装完成后，右下角弹出提示，点击 Change Language and Restart

（5）VSCode 重启后界面即为中文

5安装 Python 扩展

（1）点击左侧 扩展 图标（Ctrl + Shift + X）

（2）在搜索框中输入 Python

（3）找到微软官方发布的 "Python" 扩展（作者为 Microsoft），点击 Install

（4）安装完成后，VSCode 右下角状态栏会显示当前 Python 版本信息

💡 提示：如果未自动识别 Python，按 Ctrl + Shift + P，输入 "Python: Select Interpreter"，手动选择 Python 3.9.5 路径。

6设置 VSCode 主题

（1）按 Ctrl + K，再按 Ctrl + T 打开主题选择面板

（2）在顶部搜索框中选择 "浅色主题"（如 Light+ 等）

（3）点击即可切换，立即生效

📋 说明：也可通过菜单 文件 → 首选项 → 颜色主题 进行切换。

7配置工作目录自动定位

默认情况下，VSCode 运行 Python 文件时，工作目录可能是 VSCode 打开的根目录，而非 .py 文件所在的文件夹，导致相对路径读取文件失败。以下提供两种解决方案：

方法一：代码中手动设置（临时生效）

在每个 .py 文件头部添加以下两行代码：

import osos.chdir(os.path.dirname(os.path.abspath(__file__)))

然后通过以下方式运行：

（1）点击编辑器右上角的 运行按钮 ▶（2）或右键点击编辑器 → 选择 "在终端中运行 Python 文件"

⚠ 注意：此方法需要每个 .py 文件都添加代码，仅适合临时使用。

推荐方案方法二：修改 VSCode 设置（永久生效）

（1）按 Ctrl + ,（逗号）打开 设置 界面

（2）在搜索框中粘贴 python.terminal.executeInFileDir

（3）找到对应选项，将 勾选框打上 ✅

（4）继续在搜索框中粘贴 terminal.integrated.cwd

（5）在输入框中填入 ${fileDirname}

（6）关闭并重启 VSCode

✅ 完成效果：以后在 VSCode 中运行任何 .py 文件，工作目录都会自动切换到该文件所在的文件夹，使用相对路径即可正常工作。

📋 配置完成检查清单