利用VSCode搭建轻量级PythonWeb开发工作台-VSCode-PHP中文网

vscode比pycharm更适合轻量级web开发，因其启动快、内存占用低、多语言支持原生（html/css/js/python），插件按需加载且终端集成自然；pycharm资源消耗大（开flask项目常占1gb内存）、前端文件支持生硬，需专业版才完善web开发体验。

利用vscode搭建轻量级pythonweb开发工作台

为什么VSCode比PyCharm更适合轻量级Web开发

因为Web开发常需多语言协作（HTML/CSS/JS/Python）、快速切换项目、低内存占用，而VSCode启动快、插件按需加载、终端集成自然，PyCharm在纯Python场景强，但开一个Flask项目就吃掉1GB内存，且对前端文件支持生硬。

必须安装的4个核心插件（缺一不可）

只装Python插件是不够的——它不处理模板语法高亮、HTTP调试或前端资源联动。以下插件组合覆盖Django/Flask/FastAPI三类主流框架：

Python（微软官方）：提供debugpy调试器、Pylance类型检查、venv自动识别
Live Server：右键HTML文件直接起本地HTTP服务，配合Flask模板热刷新
Auto Rename Tag：改<div>时自动同步闭合标签，避免Jinja2模板里写错结构 <li> <code>REST Client：直接在.http文件里发GET/POST请求测试API端点，不用切Postman

调试Flask/Django时`launch.json`的关键配置

默认生成的launch.json跑不起来Web应用，常见错误是ModuleNotFoundError或Address already in use。关键要改三项：

"module": "flask"（不是"script"）+ "env": {"FLASK_APP": "app.py", "FLASK_ENV": "development"}
Django项目必须加"args": ["runserver", "--noreload"]，否则热重载会和VSCode调试器冲突
"console": "integratedTerminal"，别用externalTerminal——Web服务需要持续监听终端输出

示例片段：

python-pro

高级 Python 特性、异步编程、性能调优、静态类型、内存管理、Python 内部机制及生态库方面的专家。

下载

{
  "configurations": [{
    "name": "Launch Flask",
    "type": "python",
    "request": "launch",
    "module": "flask",
    "env": { "FLASK_APP": "app.py" },
    "args": ["run", "--no-debugger", "--no-reload"],
    "console": "integratedTerminal"
  }]
}

虚拟环境激活后仍提示`pip`找不到包？

这是VSCode没正确绑定解释器路径导致的——即使终端里source .venv/bin/activate成功，VSCode可能还在用系统Python。解决方法只有一步：

按Ctrl+Shift+P → 输入Python: Select Interpreter → 在列表里选中.venv目录下的python（Windows是.venv\Scripts\python.exe，macOS/Linux是.venv/bin/python）。注意：必须选中带.venv路径的条目，不能只选“Python 3.12”这种模糊名称。

选完后看左下角状态栏，应该显示Python 3.12.4 (.venv)，此时pip install flask才真正装进虚拟环境。