文章目录
- 开始之前
- 一、下载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:\VSCode | D:\我的软件\VSCode | 运行代码报路径错误 |
| 不含空格 | D:\VSCode | D:\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 | 中文界面 | 是 |
| Python | Microsoft | 语法高亮、补全、运行与调试 | 是 |
安装方式
按Ctrl+Shift+X打开扩展面板,搜索扩展名,找到发布者为 Microsoft 的那一项,点 Install。扩展装完不需要重启软件。
关于装扩展的建议
按需安装,不要一次装齐。扩展在软件启动时全部加载,装几十个会让启动明显变慢、内存占用升高。
| 学习方向 | 建议装的扩展 |
|---|---|
| Python | Python |
| 前端 / 网页 | 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 | 终端输出正确结果 |