Appearance
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",
}- ddd
