☰
VSCode下载安装配置图文教程-Windows新手从下载到写出第一个Python程序的完整步骤(含汉化与插件推荐)
2026/10/14 4:12:03 网站建设 项目流程

文章目录

    • 开始之前
    • 一、下载VSCode安装包
    • 二、安装 VSCode
      • 步骤 1:启动安装程序
      • 步骤 2:接受许可协议
      • 步骤 3:选择安装路径
      • 步骤 4:选择开始菜单文件夹
      • 步骤 5:选择附加任务
      • 步骤 6:安装并完成
    • 三、汉化界面
    • 四、安装 Python 环境
      • 安装要点
      • 验证 Python 是否装好
    • 五、安装扩展插件
      • 安装方式
      • 关于装扩展的建议
    • 六、写出并运行第一个程序
      • 建项目文件夹
      • 用 VSCode 打开文件夹
      • 新建文件并写代码
      • 运行程序
      • 试试 AI 补全
    • 七、常用快捷键
    • 八、常见问题
    • 九、配置完成核对

整个过程中真正需要留意的只有两个地方——安装路径和附加任务勾选。这两处处理好,后面的步骤基本不会卡住。

开始之前

准备项建议原因
系统Windows 10 / 11旧版本也可安装
学习方向先确定写什么语言决定后面要装哪个运行环境
安装位置D 盘或 E 盘的英文目录避免占用系统盘、避免路径报错
时间约 10 分钟含下载、安装、配置、验证

本文以 Python 为例演示,其他语言的流程相同,只是运行环境和扩展不同。

一、下载VSCode安装包

安装包下载:https://gitee.com/cx2021/ai

二、安装 VSCode

步骤 1:启动安装程序

双击.exe文件,安装向导立即弹出,不需要等待解压过程。

步骤 2:接受许可协议

勾选「I accept the agreement」,点下一步。软件免费,不需要序列号,也不需要登录账号。

步骤 3:选择安装路径

默认路径在 C 盘,建议改成 D 盘下的英文目录。

两个要求

要求正确示例错误示例后果
不含中文D:\VSCodeD:\我的软件\VSCode运行代码报路径错误
不含空格D:\VSCodeD:\My Tools\VSCode个别扩展调用外部命令失败

为什么建议不装 C 盘:软件本体和后续安装的扩展都会占用空间。C 盘除了装系统还要存放虚拟内存和系统更新文件,空间被占满时整机运行会明显变慢。装在数据盘则没有这个顾虑。

步骤 4:选择开始菜单文件夹

保持默认,点下一步。这一步只决定开始菜单里快捷方式的名字。

步骤 5:选择附加任务

这一页建议全部勾选,每个选项对应一个日常使用场景。

选项作用不勾选的影响
创建桌面快捷方式桌面直接启动需从开始菜单启动
添加到 PATH命令行可用code命令命令行提示找不到命令
通过 Code 打开(文件右键)右键文件直接打开只能手动拖入
通过 Code 打开(目录右键)右键文件夹打开整个项目无法从文件夹进入
注册为受支持文件类型的编辑器双击代码文件用 VSCode 打开双击.py时不用 VSCode 打开

其中「添加到 PATH」对后面装扩展和跑代码有实际影响。装 Python 扩展时,扩展需要通过命令行调用 Python 解释器;这条链路依赖 PATH 配置正确。

步骤 6:安装并完成

点「安装」,等待两三分钟。完成后勾选「运行 Visual Studio Code」,点「完成」直接打开软件。安装过程无需重启电脑。

三、汉化界面

首次启动时是英文界面。中文化通过官方语言包完成,不需要第三方汉化包。

步骤操作
1按 Ctrl+Shift+X 打开扩展面板(也可点左侧四个小方块的图标)
2搜索框输入Chinese
3找到Chinese (Simplified),确认发布者为 Microsoft
4点击 Install,几秒完成
5点右下角提示中的 Restart,重启软件

重启后菜单栏显示为中文,能看到「文件」「编辑」「查看」「运行」等项。

认准发布者:扩展市场里搜Chinese会出现多个结果,只需要发布者为 Microsoft 的那个。第三方语言包在软件更新后可能出现界面部分英文的情况。

如果重启后仍是英文:按Ctrl+Shift+P打开命令面板,输入Configure Display Language,在列表中选择zh-cn,再重启一次。

四、安装 Python 环境

这一步最容易被跳过。VSCode 是编辑器,不含 Python 解释器——代码写出来是一回事,让电脑执行它是另一回事。

安装要点

步骤操作注意
1到 Python 官网下载安装包python.org
2运行安装程序安装界面底部有选项要留意
3勾选「Add Python to PATH」这一项必须勾,否则命令行找不到 python
4点击 Install Now等待安装完成
5验证安装命令行执行python --version

「Add Python to PATH」这一项为什么关键

PATH 是 Windows 的环境变量,里面保存着一串目录路径。在命令行输入命令时,系统会到这些目录里依次查找程序。把 Python 加入 PATH 后,命令行才能识别python命令,VSCode 的 Python 扩展也才能自动找到解释器。

漏勾的表现是:命令行执行python提示「不是内部或外部命令」,VSCode 右下角提示未选择解释器。补救方式是重新运行 Python 安装程序,选 Modify 补勾这一项。

验证 Python 是否装好

按 Win+R 输入cmd回车,在命令行窗口依次执行:

python --version pip --version

两条命令都返回版本号,说明环境配置正确。

五、安装扩展插件

汉化完成后,装两个扩展就能开始写 Python 了。

扩展发布者作用是否必装
Chinese (Simplified)Microsoft中文界面是
PythonMicrosoft语法高亮、补全、运行与调试是

安装方式

按Ctrl+Shift+X打开扩展面板,搜索扩展名,找到发布者为 Microsoft 的那一项,点 Install。扩展装完不需要重启软件。

关于装扩展的建议

按需安装,不要一次装齐。扩展在软件启动时全部加载,装几十个会让启动明显变慢、内存占用升高。

学习方向建议装的扩展
PythonPython
前端 / 网页Live Server、HTML CSS Support
C / C++C/C++
通用效率代码格式化工具(按需)

认准发布者。常用扩展的官方版本由 Microsoft 发布,在扩展详情页可以看到发布者名称。第三方版本可能更新滞后。

暂时用不到的可以停用。在扩展面板按「已启用」筛选,右键选择停用,需要时再启用,不必卸载。

六、写出并运行第一个程序

环境齐了之后,用一个小程序验证整条链路。

建项目文件夹

在 D 盘建一个英文名的文件夹,例如D:\code\python-practice。

项目文件放在纯英文路径下很重要——路径含中文时,运行代码可能报路径解析错误。文件名本身可以用中文,但所在目录的路径建议保持英文。

用 VSCode 打开文件夹

在文件夹空白处右键,选择「通过 Code 打开」。

用这种方式打开,VSCode 会把该文件夹识别为项目根目录,扩展的补全和索引功能才能覆盖整个项目。如果只是把单个文件拖进编辑器,扩展只能看到那一个文件,补全效果会打折。

新建文件并写代码

在左侧资源管理器里右键,选择「新建文件」,命名为hello.py,输入:

name=input("请输入你的名字:")print(f"你好,{name}!欢迎开始学习 Python。")

保存按Ctrl+S。

关于文件后缀:Python 文件的后缀是.py,新建文件时要手动写上。没有后缀的文件 VSCode 无法识别语言类型,也不会有语法高亮。

运行程序

按Ctrl+F5运行(不调试模式),下方终端窗口会执行代码。

如果是第一次运行,VSCode 可能会提示选择 Python 解释器,点击提示中的「选择解释器」,选择已安装的 Python 版本即可。选择一次之后就会记住。

终端里显示提示文字后,输入名字并回车,程序输出结果:

请输入你的名字:小明 你好,小明!欢迎开始学习 Python。

看到这个输出,说明整条链路已经打通——编辑器、扩展、Python 环境都配置正确。

试试 AI 补全

Python 扩展自带基础的代码补全。新建一个文件,输入:

# 计算 1 到 100 的累加和

换行后输入sum,会看到补全提示。这是编辑器最基本的能力,也是它比记事本好用的地方——不用记住每个函数的完整拼写。

七、常用快捷键

快捷键功能说明
Ctrl+S保存文件或按 Ctrl+, 搜索auto save改成自动保存
Ctrl+C / Ctrl+V复制、粘贴光标在行内时不选中内容,直接整行操作
Ctrl+F文件内查找长代码里定位变量名
Ctrl+/注释、取消注释临时停用一段代码
Ctrl+Shift+X扩展面板装插件
Ctrl+Shift+P命令面板记不住菜单位置时按功能名搜索
Ctrl+F5运行程序需要先装对应语言扩展
Ctrl+`打开终端反引号键,位于数字 1 左侧

建议开启自动保存:按Ctrl+,打开设置,搜索auto save,值改为afterDelay。这样编辑后自动保存,能避开「代码改了但运行结果没变」——这种情况通常是改了没保存,运行的是上一次的版本。

八、常见问题

运行代码提示找不到 python

两种可能:一是没装 Python 解释器;二是装 Python 时漏勾了「Add Python to PATH」。在命令行执行python --version可以判断——提示找不到命令属于第二种,重新运行 Python 安装程序选 Modify 补勾。

VSCode 右下角提示未选择解释器

点击提示文字,在列表中选择已安装的 Python 版本。如果列表是空的,说明 Python 没装好或没加入 PATH。

提示路径包含中文

项目文件夹的路径里有中文。把项目移到纯英文路径下,例如D:\code\project1。

命令行提示 code 不是内部或外部命令

安装 VSCode 时漏勾了「添加到 PATH」。重跑一次安装程序补勾即可,不需要卸载。补勾后要关掉已打开的命令行窗口再重新打开,环境变量在新的进程启动时才会读取。

界面还是英文

按Ctrl+Shift+P输入Configure Display Language,选择zh-cn后重启。前提是已经装了官方中文语言包。

扩展装多了软件变慢

在扩展面板按「已启用」筛选,停用暂时不用的扩展。也可以用命令面板执行Developer: Show Running Extensions查看各扩展的启动耗时,定位占用较高的那个。

需要装哪些扩展才能开始学 Python

两个就够:Chinese (Simplified) 用于中文界面,Python 用于语法支持和运行调试。其他扩展等实际遇到需求时再装。

装完需要重启电脑吗

一般不需要。右键菜单没立即生效时,注销一次即可。

换电脑要重新装吗

需要重新安装 VSCode 和 Python。VSCode 提供设置同步功能,登录微软或 GitHub 账号后,设置、快捷键、扩展列表可以同步到新设备。

能装到 U 盘吗

可以。官方提供免安装的 Zip 版本,解压到 U 盘后运行,配置和数据保存在同目录下。

九、配置完成核对

核对项检查方法合格标准
VSCode 能启动双击桌面图标几秒内打开
安装位置查看快捷方式的目标路径D 盘的英文目录
界面语言观察菜单栏显示中文
PATH 配置命令行执行code --version返回版本号
右键菜单在文件夹上右键有「通过 Code 打开」
Python 环境命令行执行python --version返回版本号
Python 扩展打开.py文件有语法高亮和补全
代码能运行按 Ctrl+F5终端输出正确结果

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询