安装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
}
}
保存时自动格式化并整理导入语句。
|Git删除了文件，但还会在Git 仓库历史中遗留。 - 想要从 Git 历史移除敏感信息（密码、密钥、token、私钥） - 想要删除意外提交的大文件 - 想要重写 Git 历史、移除特定文件的所有痕迹 - 提到 "force push"、"重写 commit 历史" - 需要从所有分支、所有 tag 中删除某个文件
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 开发所需的核心功能。环境配置一次，多个项目复用，开发效率显著提升。
