第 5 课 · 阶段一 · 环境搭建

安装与配置 VS Code

这一课手把手配置 VS Code:下载安装、汉化、安装 Python 插件、新建项目、一键运行代码,外加常用快捷键和避坑指南。

第 5 课阶段一 · 环境搭建难度:入门建议时长:30 分钟关键词:VS Code · 汉化 · Python 插件 · 运行

🎯 学完本课你将掌握

  • 完成 VS Code 的下载与安装
  • 汉化界面并安装 Python 扩展
  • 新建 .py 文件并一键运行代码
  • 掌握 6 个最常用的快捷键

一、下载与安装 VS Code

  1. 1
    打开官网 https://code.visualstudio.com/,点击 Download 下载。
  2. 2
    Windows 用户双击下载的 .exe;安装时建议勾选“添加到 PATH”“在文件资源管理器上下文菜单中添加‘通过 Code 打开’”。
  3. 3
    macOS 用户把下载的 .app 拖进 Applications;Linux 用户可下载 .deb/.rpm 或用包管理器安装。
  4. 4
    安装完成后打开 VS Code,界面默认是英文。

二、汉化界面

  1. 1
    点击左侧竖排图标栏最上方的“扩展”(或按 Ctrl+Shift+X)。
  2. 2
    在搜索框输入 Chinese,找到“中文(简体) Language Pack for Visual Studio Code”。
  3. 3
    点击 Install 安装,右下角会提示 Restart,点击重启即可变成中文界面。

三、安装 Python 扩展(最关键)

  1. 1
    再次打开扩展面板,搜索 Python。
  2. 2
    安装由 Microsoft 出品的 “Python”(红色图标,通常排在第一位)。
  3. 3
    安装完后,VS Code 会自动识别你电脑上的 Python 解释器;如果没识别,按 Ctrl+Shift+P 输入 Python: Select Interpreter 手动选择。
✅ 要点
装好 Python 扩展后,写代码会有智能提示(打出 pri 自动补全 print),还能一键运行,体验瞬间提升。

四、新建项目并运行第一个程序

  1. 1
    菜单“文件 → 打开文件夹”,选择或新建一个文件夹作为你的学习目录(例如 D:\PythonLearn)。
  2. 2
    在左侧资源管理器点击“新建文件”,命名 hello.py(后缀必须是 .py)。
  3. 3
    输入代码:print("Hello, VS Code!")。
  4. 4
    点击右上角的“运行 ▷”按钮(或按 F5 / 右键选择“在终端中运行 Python 文件”)。
  5. 5
    下方终端窗口会显示输出:Hello, VS Code!
hello.py
1print("Hello, VS Code!")
2print("我正在用编辑器运行 Python,太棒了!")

五、常用快捷键

快捷键功能
Ctrl+S保存文件(写完代码一定先保存)
F5调试运行当前文件
Ctrl+Shift+P打开命令面板
Ctrl+Shift+X打开扩展面板
Ctrl+/注释/取消注释选中行
Shift+Alt+↓ / ↑向下/向上复制当前行

六、常见错误与解决

常见错误与解决

错误现象原因 / 解决方法
运行报“未选择解释器”按 Ctrl+Shift+P → Python: Select Interpreter → 选择你安装的 Python 3.x。
终端里 python 不是内部命令说明 Python 没加 PATH,回到第 2 课步骤五补上,然后重启 VS Code。
中文乱码一般不影响运行;若显示乱码,可在文件右下角把编码改为 UTF-8。
运行按钮是灰色确认文件后缀是 .py,且已安装 Python 扩展并选中解释器。
✍️ 小练习
在 VS Code 里新建文件 myfirst.py,写入两行 print 输出你的名字和年龄,运行并确认输出正确。
📌 本节小结
VS Code 配置三步走:下载安装 → 汉化 + 装 Python 插件 → 新建 .py 文件一键运行。快捷键能大幅提升效率,建议把常用 6 个记下来。VS Code 将伴随你整个学习旅程,从现在开始,所有代码都用它来写。