VS Code + Python

发表于 更新于 分类于 ， 本文字数： 1.7k 阅读时长 ≈ 6 分钟

version 1.0 by Oct. on 2025.12.10 包括：本体与编译器下载安装，python虚拟环境设置

纯属个人使用偏好，仅代表个人工作流

1.VS code下载

  1. 下载
    • 官网选择合适版本VS code官网
    • 个人电脑通常是windows x64
  2. 安装
    • 双击安装包开始安装
    • 勾选“我同意此协议”–>点击下一步
    • 自定义下载安装目录（不要再下c盘里了）–>点击下一步
    • 不用管–>点击下一步
    • 勾选附加项：
      • （必选）“将code注册为受支持的文件类型的编辑器”
      • （必选）“添加到PATH”
      • （可选）“创建桌面快捷方式”
      • 选完点击下一步
    • 点击安装–>等待–>点击完成
  3. （可选）中文扩展下载（实话讲，都到这年纪了，还是适应一下英文环境吧）
    • 大体流程和[[VS Code+Python#3.1.VS code安装Python扩展]]小节一致，可跳转查看
    • 区别在于搜索时，输入“Chinese”，install对应的中文包

2.Python本体下载

  1. 下载
    • 访问python官网python官网
    • 点击一级菜单“download”–>选合适的版本
      • 个人比较偏好下载最新版本的stable releases
      • 个人电脑通常是windows 64-bit
      • 不开vpn下载慢，开vpn会快一点
  2. 安装
    • 双击安装包
    • 勾选“use admin privileges when installing py.exe”和“add python.exe to PATH”–>点击自定义安装“customize installation”
    • optional features
      • 勾选“documentation”
      • 勾选“pip” （用来下第三方包的）
      • 勾选“tcl/tk and IDLE”（tkinter用来渲染前端的，如果不装，后期写网页有点麻烦）
      • 勾选“python test suite”
      • 勾选“py launcher”和“for all users”
      • 总的来说，就是建议全选，然后点击next
    • advanced options
      • 勾选“install xxx for all users”
      • 勾选“associate files with python”
      • 勾选“create shortcuts for installed applications”
      • 勾选“add python to environment variables”
      • 勾选“precompile standard library”
      • 勾选“download dubugging symbols”
      • 自定义安装位置，不要选c盘，可以在本体文件夹里新建一个“python_environment”文件夹–>点击install
  3. 验证
    • 同时按下键盘win+r --> 输入cmd --> 打开powershell
    • 输入“python -V”（注意有空格）–> 回车
    • 如果有版本号显示，说明安装成功

3.VS code+Python

3.1.VS code安装Python扩展

vscode本身不支持python开发，所以要安装插件

  1. 左侧活动栏，点击扩展extensions图标（四个方格）
  2. 在搜索框中输入“python”，选择Microsoft开发的官方插件，点击蓝色“install”按键
  3. 安装成功后，左侧活动栏会出现python图标

3.2.配置python解释器

vscode每个项目都可以配置一个特定的python解释器
为了确保使用正确版本的python解释器，需要进行如下配置：

  1. ctrl+shift+p（windows/Linux）打开命令面板（页面最上方一横条输入栏）
  2. 输入“Python: Select Interpreter”–>点击下方选择该命令
  3. vscode会列出当前系统中安装的所有python解释器，选择需要的版本。如果使用虚拟环境，要选择对应的虚拟环境解释器（强烈推荐，请养成良好的编程习惯）

3.3.虚拟环境管理

对于每个项目，都建议使用虚拟环境来管理依赖，避免与全局python环境产生冲突

  • 原因1： 不同项目import的第三方包可能存在冲突。比如，项目A import了numpy的版本1，如果装在全局python环境中，当项目B 需要import numpy的版本2时，就寄了。但是如果使用虚拟环境管理，那么项目A和B之间的环境是隔离开的，也就是说，项目A的虚拟环境中安装的是numpy的版本1，项目B的虚拟环境中安装的是numpy的版本2，从而避免了环境冲突。
  • 原因2： 代码公开/共享时，可以通过requirements.txt精准还原部署环境。人话的意思是，方便别人复现你的代码，不然还得手动查你import哪些包及其对应版本，然后还得手动一个个下载。
  • 原因3： 可以自由指定解释器版本。

3.3.1.创建虚拟环境

  1. ctrl+英文上点（英文输入法下tab键上边那个键/和~同一个键）–> 打开终端terminal，并进入项目目录
  2. python 3版本的创建虚拟环境命令：
    python -m venv venv_name
    • python 指调用python解释器
    • -m 表示要运行一个模块
    • venv 是python内置的虚拟环境模块（-m后面调用的模块就是它）
    • venv_name 是你要创建的虚拟环境的目录名称
      例如，项目文件夹是D:\code\pythonprojecteg，那么创建后的虚拟环境文件夹为D:\code\pytonprojecteg\venv_name\
  3. 通常来说，创建虚拟环境之后，vscode会自动识别，右下角会弹出提示框，询问你是否想选择它作为这个workspace folder的环境，那么点击“yes”即可
  4. 你也可以在页面右下角切换其他的python解释器运行

3.3.2.激活虚拟环境

  1. windows激活命令：
    .\venv_name\Scripts\activate
    .\venv_name\Scripts\Activate.ps1
  2. mac或Linux激活命令
    source venv_name/bin/activate

  • 如果遇到不能执行脚本的错误，可能是因为电脑安全策略防止执行不信任的脚本

    1. 以管理员身份打开powershell
    2. 命令行中输入“set-executionpolicy remotesigned”
    3. 提示是否更改策略时，输入“y”，回车，执行脚本

  • 激活成功后，终端terminal的提示符会变成绿色的虚拟环境名称，表示已经成功进入虚拟环境

3.3.3.安装python第三方包

这里只介绍pip命令，因为最直接
其他anonconda类似的软件也可以管理虚拟环境，但如开篇所说，这里只介绍个人偏好

  • pip命令：pip install 第三方包的名称

3.4.配置调试器

用于支持python代码单步执行、变量监测、断点设置等

  1. 左侧活动栏，点击调试（run and debug）图标（长着播放按钮和瓢虫）
  2. 点击蓝色链接“create a launch.json file”，创建一个launch.json文件
  3. 最上侧选择栏，选择“python debugger”，选择“python file”，作为环境
  4. vscode会自动生成一个配置文件，你可以根据需求自行修改调试配置

然后可以设置断点并对代码进行调试
调试面板按钮从左往右依次是：

  1. 继续运行，快捷键F5
  2. 单步跳过，快捷键F10
  3. 单步调试，快捷键F11
  4. 单步跳出，快捷键shift+F11
  5. 重新运行，快捷键ctrl+shift+F5
  6. 停止调试，快捷键shift+F5