Skip to content

vscode编辑器上如何使用python

1. VSCode + Python 扩展 + uv 组合,默认就是不识别 uv 安装的包,所以鼠标放上去没提示、没跳转、没智能补全

Python 语言服务器(Language Server)是 VSCode 提供智能代码功能的引擎。它负责:

  • 代码补全(IntelliSense)
  • 跳转到定义(Go to Definition)
  • 查找所有引用
  • 悬停提示
  • 语法错误检查等

常用的语言服务器有 Pylance(Microsoft 官方推荐,速度快、功能强)和 Jedi(较老的实现)。当设置为 "None" 时,所有这些功能都会被禁用。

核心原因

uv 安装的包 不在 VSCode 默认识别的路径里,Pylance(这个语言服务器作用是用来代码分析、跳转和自动补全等) 找不到,所以:

  • 没有提示
  • 没有定义跳转
  • 没有类型检查
  • 鼠标悬浮无信息
解决方法

a. 用 uv 创建虚拟环境

uv venv  # 创建虚拟环境

b. 然后设置解释器(以下有2种方式设置):

  • 第一种方式是在VSCode 右下角选择解释器: ./.venv/Scripts/python.exe (Windows) ./.venv/bin/python (Mac/Linux)
  • 第二种方式是使用快捷键 “Ctrl+Shift+P”,输入 “Python: Select Interpreter”,选择项目所需的 Python 解释器。

c. 然后设置 Python 语言服务器:打开 VS Code 设置,搜索 “Python”,找到 “Language Server” 选项,设置为 “Pylance”。

d. 重启语言服务器 按 Ctrl+Shift+P,输入并执行 Python: Restart Language Server,等待几秒钟让语言服务器重新索引代码。

2. 参数类型检查校验配置

安装Python插件时会自带安装Pylance(类型检查插件),直接在项目根目录下创建.vscode/settings.json,然后配置.vscode/settings.json:
{
     "python.analysis.typeCheckingModel": "strict"
}
或者创建 pyrightconfig.json,开启严格检查,但同时把“未知类型”的桑格常见警告关掉了。
这样能避免报太多错,比较适合刚开始用类型检查,不想太严格的情况。
{
     "typeCheckingMode":"strict",
     "reportUnknownVariableType":"none",
     "reportUnknownMemberType":"none",
     "reportUnknownArgumentType":"none",
}
  1. ddd

创作不易请尊重他人劳动成果,未经授权禁止转载!
Released under the MIT License.