安装Python和VSCode并验证版本,2. 安装Python、Pylance等扩展,3. 配置解释器选择虚拟环境,4. 启用Linting与Black+isort格式化,5. 设置launch.json进行调试,6. 配置pytest测试,7. 优化settings.json提升体验,8. 推荐使用独立虚拟环境。
visual studio code(vscode)是目前最受欢迎的 python 开发工具之一,轻量、免费、扩展丰富。通过合理配置,可以将 vscode 打造成一个全功能的 python 开发环境,支持代码补全、调试、测试、格式化、linting、虚拟环境管理等功能。以下是一份详细的配置指南。
1. 安装 Python 和 VSCode
确保系统中已安装 Python,并能通过命令行调用。
- 前往 python.org 下载并安装最新稳定版 Python(推荐 3.9+)
- 安装时勾选“Add Python to PATH”
- 打开终端运行
python --version或python3 --version验证安装 - 下载并安装 Visual Studio Code
2. 安装必要扩展
打开 VSCode,进入扩展市场(左侧活动栏拼图图标),搜索并安装以下核心扩展:
- Python(由 Microsoft 提供)— 核心支持,包含 IntelliSense、调试、Linting 等
- Pylance — 提供高级语言智能提示,大幅提升补全和类型检查能力
- Python Docstring Generator — 快速生成文档字符串
- autoDocstring — 支持 Google、NumPy 等风格 docstring 自动生成
- Black Formatter 或 autopep8 — 代码格式化工具
- isort — 自动整理 import 语句顺序
- GitLens — 增强 Git 功能(可选但推荐)
3. 配置 Python 解释器
确保 VSCode 使用正确的 Python 解释器,尤其是项目使用虚拟环境时。
- 按下
Ctrl+Shift+P打开命令面板 - 输入 “Python: Select Interpreter” 并选择
- 从列表中选择你希望使用的解释器(如全局 Python 或虚拟环境中的)
- 若使用虚拟环境(venv、conda 等),需先激活环境再选择其下的
python可执行文件
VSCode 通常会自动检测到虚拟环境(位于项目根目录的 .venv、venv 或 env 文件夹),但仍建议手动确认。
立即学习“Python免费学习笔记(深入)”;
4. 启用 Linting 和格式化
Linting 能帮助发现代码错误和风格问题,格式化则保持代码整洁。
启用 Linting:
- 在命令面板中运行 “Python: Select Linter”
- 选择你喜欢的 linter,例如:
pylint、flake8、pydocstyle等 - 安装对应工具到当前环境:
pip install pylint或pip install flake8
配置代码格式化工具:
- 推荐使用 Black + isort
- 安装:
pip install black isort - 在 VSCode 设置中添加以下配置(
settings.json):
{
"python.formatting.provider": "black",
"python.formatting.blackArgs": [],
"python.sortImports.provider": "isort",
"editor.formatOnSave": true,
"editor.codeActionsOnSave": {
"source.organizeImports": true
}
}
保存时自动格式化并整理导入语句。
睿拓智能网站系统-网上商城1.0免费版软件大小:5M运行环境:asp+access本版本是永州睿拓信息专为电子商务入门级用户开发的网上电子商城系统,拥有产品发布,新闻发布,在线下单等全部功能,并且正式商用用户可在线提供多个模板更换,可实现一般网店交易所有功能,是中小企业和个人开展个人独立电子商务商城最佳的选择,以下为详细功能介绍:1.最新产品-提供最新产品发布管理修改,和最新产品订单查看2.推荐产
5. 配置调试环境
VSCode 提供强大的图形化调试功能。
- 在项目根目录创建
.vscode/launch.json - 点击侧边栏虫子图标,点击“创建 launch.json”
- 选择 “Python” 环境
- 常用配置示例:
{
"version": "0.2.0",
"configurations": [
{
"name": "Python 调试",
"type": "python",
"request": "launch",
"program": "${file}",
"console": "integratedTerminal",
"justMyCode": true
}
]
}
设置断点后按 F5 即可启动调试。
6. 运行和测试集成
VSCode 支持单元测试框架(如 unittest、pytest)的发现与运行。
- 在命令面板运行 “Python: Configure Tests”
- 选择测试框架(如 pytest)
- 指定测试目录(如
tests或test_*.py) - 安装 pytest:
pip install pytest
配置完成后,测试资源管理器会显示所有测试用例,可点击运行或调试单个测试。
7. 推荐 settings.json 配置
在项目或用户设置中添加以下内容,提升开发体验:
{
"python.defaultInterpreterPath": "python",
"python.linting.enabled": true,
"python.linting.pylintEnabled": true,
"python.analysis.typeCheckingMode": "basic",
"editor.suggest.snippetsPreventQuickSuggestions": false,
"python.testing.pytestEnabled": true,
"python.testing.unittestEnabled": false,
"python.terminal.activateEnvironment": true,
"python.terminal.executeInFileDir": true
}
根据项目需求调整路径和工具。
8. 使用虚拟环境(推荐)
为每个项目创建独立环境,避免依赖冲突。
- 在项目根目录运行:
python -m venv .venv - 激活环境:
Windows:.venv\Scripts\activate
macOS/Linux:source .venv/bin/activate - 安装依赖:
pip install numpy requests django... - 在 VSCode 中选择该环境的解释器
VSCode 通常会提示是否信任并激活此环境,点击“Yes”即可。
基本上就这些。完成上述步骤后,你的 VSCode 就具备了专业级 Python 开发所需的核心功能。环境配置一次,多个项目复用,开发效率显著提升。









