讲师中心 微信公众号
AI工具推荐 视频效率加速

如何在VSCode中配置Python开发环境

千浩大大_9958

千浩大大_9958

发布时间:2026-03-21 15:30:30

|

661人浏览过

|

来源于php中文网

原创

选对Python解释器并统一配置路径才能确保VSCode正常运行:需通过命令面板选择明确路径的解释器,配置python.defaultInterpreterPath固化路径,launch.json中指定相同python字段,启用Pylance并排除干扰文件。

如何在vscode中配置python开发环境

选对 Python 解释器,python 命令才不会指向错的版本

VSCode 本身不自带 Python,它靠你本地装的解释器干活。如果你机器上同时有系统自带的 python3.9、pyenv 管理的 3.11、还有 Conda 环境里的 3.12,VSCode 默认可能随便挑一个——结果就是 import torch 报错,但终端里明明能跑。

实操建议:

立即学习“Python免费学习笔记(深入)”;

VSCode
VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载
  • 按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(Mac),输入 Python: Select Interpreter,从列表里选带明确路径的项,比如 ./venv/bin/python 或 ~/miniconda3/envs/myproj/bin/python
  • 别只认“Python 3.12”,要确认路径是否对应你的项目虚拟环境;点进去看右下角状态栏,显示的路径必须和你在终端里 which python 输出一致
  • 如果列表为空,说明 VSCode 没扫描到解释器:检查是否装了 python 可执行文件,且在 $PATH 中;macOS 用户注意,/usr/bin/python3 是系统自带,不建议用于开发

settings.json 里配 python.defaultInterpreterPath 才算真正固化

光在 UI 里选一次解释器,只对当前工作区生效。关掉再打开,或者换个项目,又得重选。真正想“一劳永逸”,得写进配置。

实操建议:

立即学习“Python免费学习笔记(深入)”;

  • 打开命令面板,搜 Preferences: Open Settings (JSON),编辑 settings.json
  • 加这一行:"python.defaultInterpreterPath": "./venv/bin/python"(Linux/macOS)或 "python.defaultInterpreterPath": ".\venv\Scripts\python.exe"(Windows)
  • 路径必须是相对当前工作区根目录的,不能用 ~ 或 $HOME;绝对路径虽然能用,但换机器就失效
  • 如果项目用 Conda,路径类似 "/opt/anaconda3/envs/myenv/bin/python",记得确认该环境已创建且未被删除

调试时 launch.json 不配 python 路径,断点直接失效

即使解释器选对了,VSCode 调试器(Debugger)默认仍可能调用系统 python,导致断点不命中、变量看不到、甚至报 ModuleNotFoundError。

实操建议:

立即学习“Python免费学习笔记(深入)”;

  • 在项目根目录建 .vscode/launch.json,确保 configurations 下有 "python" 字段,例如:
    {
      "version": "0.2.0",
      "configurations": [
        {
          "name": "Python: Current File",
          "type": "python",
          "request": "launch",
          "module": "pytest",
          "console": "integratedTerminal",
          "justMyCode": true,
          "python": "./venv/bin/python"
        }
      ]
    }
  • "python" 字段值必须和 python.defaultInterpreterPath 一致;漏写或写成 "pythonPath"(旧版字段)会导致配置被忽略
  • 如果用 pytest 或 flask run 启动,"module" 和 "args" 要配对,否则调试器启动后立刻退出

Pylance 和 Python 扩展不是一回事,关掉 Pylance 就等于放弃类型提示

很多人装了 Python 扩展就以为万事大吉,其实核心语言支持(跳转、补全、类型推导)靠的是 Pylance——它是独立扩展,可开关,且默认启用。关了它,str. 后面几乎没补全,def foo(x: int) 的类型检查也停摆。

实操建议:

立即学习“Python免费学习笔记(深入)”;

  • 检查扩展面板里 Pylance 是否已安装并启用;如果禁用了,重启 VSCode 后类型提示不会自动恢复
  • 若提示“no stubs found”或补全卡顿,去 settings.json 加:"python.analysis.extraPaths": ["./src"],把自定义模块路径告诉 Pylance
  • 不要为了“快一点”关 Pylance——现代机器上它的内存占用可控;真卡顿优先查是不是 __pycache__ 或大日志文件被误纳入索引(用 python.analysis.exclude 排除)
VSCode 的 Python 配置不是“设一次就完事”,解释器路径、调试器路径、语言服务器路径三者必须严格对齐,差一个字符都可能让 import 失败或断点失灵。最常被忽略的是:改了 settings.json 后没重启窗口,或改了 launch.json 却没切回正确的 launch configuration。

热门AI工具

更多
超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

相关专题

更多
flask框架如何搭建
flask框架如何搭建

搭建步骤:1、安装Python和Pip;2、创建虚拟环境;3、安装Flask;4、创建Flask应用;5、运行应用;6、访问应用。想了解更多flask框架的相关内容,可以阅读本专题下面的文章。

3875

2024.06.27

Python Flask框架
Python Flask框架

本专题专注于 Python 轻量级 Web 框架 Flask 的学习与实战,内容涵盖路由与视图、模板渲染、表单处理、数据库集成、用户认证以及RESTful API 开发。通过博客系统、任务管理工具与微服务接口等项目实战,帮助学员掌握 Flask 在快速构建小型到中型 Web 应用中的核心技能。

5964

2025.08.25

Python Flask Web框架与API开发
Python Flask Web框架与API开发

本专题系统介绍 Python Flask Web框架的基础与进阶应用,包括Flask路由、请求与响应、模板渲染、表单处理、安全性加固、数据库集成(SQLAlchemy)、以及使用Flask构建 RESTful API 服务。通过多个实战项目,帮助学习者掌握使用 Flask 开发高效、可扩展的 Web 应用与 API。

316

2025.12.15

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2195

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3442

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1156

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

3939

2025.09.10

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

6719

2023.08.02

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

100

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn