目录

一、基础环境搭建

1.1 安装必备软件

二、Python开发核心配置

2.1 安装Python扩展

2.2 配置Python解释器

三、虚拟环境管理

3.1 创建虚拟环境

3.2 查看虚拟环境

3.3 切换虚拟环境

3.4 激活虚拟环境

3.5 虚拟环境:安装python包

3.6 退出虚拟环境

四、高效开发功能配置(可选)

4.1 配置调试器

配置

设置断点与调试

4.2 代码质量工具

配置flake8代码规范检查

自动格式化配置



一、基础环境搭建

1.1 安装必备软件

①VS Code官方下载:可参考之前文章(【VS Code】安装+配置全流程-CSDN博客

说明:看【二、安装流程】即可

Python环境安装:可参考之前文章(【python】全流程图文安装教程-CSDN博客)

说明:看【二、下载安装】即可


二、Python开发核心配置

2.1 安装Python扩展

VSCode本身并不直接支持Python开发,但我们可以通过安装插件来实现这一功能。

在 VS Code 的插件市场,搜索 “Python”,安装由微软官方维护的 Python 扩展。该插件提供了代码智能补全、调试支持、Jupyter Notebook 集成等核心功能,是 Python 开发的必备工具。

①打开VSCode,点击左侧活动栏中的“扩展”(Extensions)图标。
②在搜索框中输入“Python”,然后选择由Microsoft开发的官方插件进行安装。
③安装完成后,VSCode会自动为你启用Python语言支持,并显示相关功能。


2.2 配置Python解释器

  1. Ctrl+Shift+P​打开命令面板
  2. 点击【python:选择解释器】(找不到就输入"Python: Select Interpreter"再选择【python:选择解释器】)

(选择之后,python脚本都会基于这个版本进行运行,如果需要更换可以通过安装其他python版本进行更换即可)

3、验证配置:新建.py​文件,输入print("Hello jihaishibei")​,按F5运行

4、把【print("hello world")】写进去---→ctrl+s保存

5、运行程序

运行方法一:按【F5】 或  点击【运行---→运行调试】

运行方法二:

①复制脚本路径

②输入命令

python+脚本路径,再回车也可执行(注意:python和脚本路径中间有个空格)

说明

如果只是在VScode上配置python环境的话,到这里就结束了。

三、虚拟环境管理】主要是python项目管理的必备技能,推荐可以实践一下。


三、虚拟环境管理

在VSCode中使用虚拟环境是管理项目依赖的最佳实践。通过虚拟环境,你可以为每个项目隔离不同的包和依赖,避免不同项目之间的依赖冲突。

为什么需要虚拟环境?

通过一个对比表格说明必要性:


3.1 创建虚拟环境

以下是创建虚拟环境的步骤:

  1. 打开终端(Ctrl+​ `)并进入你的项目目录。
  2. 使用以下命令创建虚拟环境(假设使用Python 3):
python -m venv test

具体解释:

① python:调用 Python 解释器

② -m:表示要运行一个模块(module)

③ venv:这是 Python 内置的虚拟环境模块

④ test:这是你要创建的虚拟环境的目录名称,可自定义

(说明:在哪个路径下执行,就在哪个路径下创建)


3.2 查看虚拟环境


3.3 切换虚拟环境


3.4 激活虚拟环境

激活虚拟环境:

  • Windows:

.\test\Scripts\activate
  • macOS/Linux:

source venv/bin/activate

(激活成功,每行命令前缀都会有虚拟环境名称【如:test】)

【激活环境报错】

可能遇到不能执行脚本的错误:这是因为执行策略可帮助你防止执行不信任的脚本,我们把安全策略改了就行。

解决方法:

1、以管理员身份打开 PowerShell

  • 在 Windows 搜索栏中输入 PowerShell,右键点击 Windows PowerShell,然后选择 以管理员身份运行

2、查看当前的执行策略
在 PowerShell 中输入以下命令,查看当前的执行策略:

Get-ExecutionPolicy

默认情况下,你可能会看到 RestrictedRemoteSigned,这些策略会限制某些脚本的执行。

3、更改执行策略
为了允许脚本执行,可以将执行策略更改为 RemoteSignedUnrestricted(对于开发环境,RemoteSigned 通常是比较安全的选择):

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

或者,如果你需要更加宽松的策略,可以使用:

Set-ExecutionPolicy Unrestricted -Scope CurrentUser

4、确认更改
PowerShell 会要求你确认更改,输入 Y 然后按回车。

5、重新运行激活脚本
更改执行策略后,尝试vscode中再次运行虚拟环境激活脚本:

.\test\Scripts\activate

3.5 虚拟环境:安装python包

测试:

#安装numpy包
pip install numpy

#查看所有包
pip list


3.6 退出虚拟环境

不需要用或者需要换其他虚拟环境时便可退出虚拟环境

deactivate

四、高效开发功能配置(可选)

4.1 配置调试器

配置

VSCode提供强大的调试功能,支持Python代码的单步执行、变量监视、断点设置等。配置调试器的步骤如下:

1、打开VSCode中的“调试”视图(左侧活动栏中的播放按钮图标)。

2、点击“创建一个launch.json文件”链接,选择“Python”作为环境。

3、VSCode会自动生成一个launch.json​配置文件,你可以根据需要修改调试配置。

常见的调试配置包括:

1、配置断点:你可以在代码行号旁边点击设置断点,调试时程序会在这些位置暂停。

2、调试控制台:可以查看程序输出和变量值。

3、调试配置:修改launch.json​文件以支持不同的调试场景,例如运行脚本、调试测试等。

如果想要在启动调试后,自动停止在程序入口,那么在launch.json中添加下面设置:

"stopOnEntry": true

设置断点与调试

打开想要调试的python文件,然后将鼠标移动到行号的左侧(我这里选的是第3行),可以看到一个断点的标志,点击即可在该行设置断点:

"Start Debugging"来启动调试,启动调试之后,程序停在了刚才设置的断点处:

接着可以使用调试面板中的调试按钮来调试我们的程序了,调试面板中的按钮从左到右依次是:

按钮1:移动按钮,拖住后可以移动调试控制面板;
按钮2:继续运行,对应快捷键F5;
按钮3:单步跳过,对应快捷键F10;
按钮4:单步调试,对应快捷键F11;
按钮5:单步跳出,对应快捷键Shift+F11;
按钮6:重新运行,对应快捷键Ctrl+Shift+F5;
按钮7:停止调试,对应快捷键Shift+F5;


4.2 代码质量工具

配置flake8代码规范检查

  • 安装:pip install flake8

  • 修改用户设置(settings.json):

{
    "python.linting.flake8Enabled": true,
    "python.linting.enabled": true
}

自动格式化配置

  • 安装autopep8:pip install autopep8

  • 设置保存时自动格式化:
{
    "python.linting.flake8Enabled": true,
    "python.linting.enabled": true
}

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐