Logo
Published on

1.4.VSCode开发Python

Authors
  • avatar
    Name
    xiaobai
    Twitter

1.安装 VSCode

VSCode(Visual Studio Code)是微软开发的免费代码编辑器,对Python开发有很好的支持。

1.1.下载安装

  1. 访问官网
    • 打开 VSCode 官网
    • 点击 "Download for Windows/macOS/Linux" 下载对应版本
  2. 安装步骤
    • Windows: 运行下载的 .exe 文件
    • macOS: 运行下载的 .dmg 文件
    • Linux: 按照官方说明安装

2.配置 Python 开发环境

2.1.安装 Python 扩展

VSCode 需要安装 Python 扩展才能提供完整的 Python 开发支持:

  1. 打开扩展面板
    • 点击左侧扩展图标(或按 Ctrl+Shift+X
  2. 搜索并安装
    • 搜索 "Python"
    • 找到 Microsoft的Python 扩展
    • 点击 "Install" 安装

2.2.安装 Pylance 扩展

Pylance 是微软开发的 Python 语言服务器,提供强大的代码智能功能:

  1. 搜索安装
    • 在扩展面板中搜索 "Pylance"
    • 找到 Microsoft的Pylance扩展
    • 点击 "Install" 安装

注意: 安装 Python 扩展时,通常会自动推荐安装 Pylance,建议一起安装。

2.3.Python 扩展与 Pylance 的关系

2.3.1.扩展角色分工

  • Python 扩展:主扩展,提供完整的 Python 开发体验
  • Pylance 扩展:语言服务器,专门提供代码智能功能

2.3.2.功能对比

功能类型Python 扩展Pylance 扩展
调试器完整支持不支持
测试框架pytest, unittest不支持
Jupyter完整支持不支持
环境管理解释器选择不支持
代码补全基础支持高级智能补全
类型检查有限支持强大类型检查
代码导航基础支持快速精确导航
代码分析基础支持深度静态分析

2.3.3.协作关系

img

3.配置 Python 解释器

VSCode 需要知道使用哪个 Python 解释器来运行和调试代码。

3.1.方法1:使用命令面板

  1. 打开命令面板
    • Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS)
  2. 选择解释器
    • 输入 "Python: Select Interpreter"
    • 从列表中选择你需要的 Python 版本

3.2.方法2:使用状态栏

  1. 查看当前解释器
    • 查看 VSCode 底部状态栏左侧的 Python 版本信息
  2. 切换解释器
    • 点击状态栏中的 Python 版本
    • 从弹出的列表中选择新的解释器

提示: 如果系统中有多个 Python 版本,建议选择 Python 3.x 版本。

4.配置代码格式化

代码格式化可以自动整理代码风格,让代码更易读。推荐使用 Black 格式化器。

4.1.安装 Black Formatter 扩展

  1. 打开扩展面板
    • 点击左侧扩展图标(或按 Ctrl+Shift+X
  2. 搜索安装
    • 搜索 "Black formatter"
    • 找到 Microsoft的Black Formatter扩展
    • 点击 "Install" 安装

4.2.配置自动格式化

  1. 打开设置
    • Ctrl+Shift+P 打开命令面板
    • 输入 "Preferences: Open User Settings (JSON)"
  2. 添加配置 在设置文件中添加以下配置:
{
  "[python]": {
    "editor.defaultFormatter": "ms-python.black-formatter",
    "editor.formatOnSave": true
  }
}

配置说明

  • defaultFormatter:设置默认的格式化器为 Black
  • formatOnSave:保存文件时自动格式化代码

提示: 配置完成后,每次保存 Python 文件时都会自动格式化代码。

5.常用快捷键

掌握这些快捷键可以大大提高开发效率:

5.1.代码运行和调试

快捷键功能说明
Ctrl + F5运行当前文件不进入调试模式运行
F5调试当前文件进入调试模式运行
Shift + Enter运行选中代码在终端中执行选中的代码

5.2.代码导航

快捷键功能说明
F12跳转到定义查看函数或变量的定义
Ctrl + F12跳转到实现查看函数的具体实现
Shift + F12查找所有引用查找函数或变量的所有使用位置

5.3.编辑器操作

快捷键功能说明
Ctrl + `打开终端切换集成终端的显示/隐藏
Ctrl + Shift + P命令面板打开命令面板
Ctrl + ,打开设置打开 VSCode 设置

提示: 在 macOS 上,Ctrl 键通常对应 Cmd 键。

6.安装 Code Runner 扩展(可选)

Code Runner 是一个便捷的代码运行扩展,可以快速运行各种语言的代码。

6.1.安装 Code Runner

  1. 打开扩展面板
    • 点击左侧扩展图标(或按 Ctrl+Shift+X
  2. 搜索安装
    • 搜索 "Code Runner"
    • 找到 Code Runner扩展
    • 点击 "Install" 安装

6.2.配置编码设置

为了避免中文显示问题,需要配置 Python 的编码设置:

  1. 打开设置
    • Ctrl + , 打开设置
    • 搜索 "Code-runner: Executor Map"
    • 点击 "Edit in settings.json"
  2. 添加配置 Windows在设置文件中添加以下配置:
{
  "code-runner.executorMap": {
    "python": "set PYTHONIOENCODING=utf8 && python -u $fullFileName"
  }
}

MAC在设置文件中添加以下配置:

{
  "code-runner.executorMap": {
    "python": "export PYTHONIOENCODING=utf8 && python3 -u $fullFileName"
  }
}

6.3.使用方法

  • 运行代码:按 Ctrl+Alt+N 执行当前 Python 文件
  • 右键菜单:右键点击代码文件,选择 "Run Code"

注意

  • Windows 用户使用 set PYTHONIOENCODING=utf8
  • macOS/Linux 用户使用 export PYTHONIOENCODING=utf8

7.总结

现在你已经完成了 VSCode Python 开发环境的配置:

已安装的扩展

  • Python 扩展(核心功能)
  • Pylance 扩展(智能代码功能)
  • Black Formatter 扩展(代码格式化)
  • Code Runner 扩展(快速运行代码)

已配置的功能

  • Python 解释器选择
  • 自动代码格式化
  • 编码设置
img