必须在项目根目录创建虚拟环境并手动选择对应解释器路径：先运行python -m venv .venv，再通过Ctrl+Shift+P执行“Python: Select Interpreter”，选中.venv/bin/python（macOS/Linux）或.venv\Scripts\python.exe（Windows），且需关闭所有文件夹后重新用“打开文件夹”加载项目根目录以确保生效。
VSCode 里怎么选对 Python 解释器？
选错解释器是微服务集群开发中最隐蔽也最致命的问题——你写的 fastapi 服务跑不起来，uvicorn 报 ModuleNotFoundError，十有八九不是代码问题，而是 VSCode 没用上你虚拟环境里的 Python。
关键操作只有两步：
1. 在项目根目录下打开终端（Ctrl+`），运行 python -m venv .venv 创建隔离环境
2. 按 Ctrl+Shift+P 输入 Python: Select Interpreter，从列表里选中 .venv/bin/python（macOS/Linux）或 .venv\Scripts\python.exe（Windows）
⚠️ 容易踩的坑：
• 不要依赖状态栏右下角显示的解释器路径——它可能缓存了旧值，必须手动重选
• 如果列表里没出现 .venv，先关掉所有文件夹，重新用「文件 → 打开文件夹」打开项目根目录
• 多个微服务子项目（如 auth-service、order-service）必须各自独立创建 .venv 并分别选解释器，混用会导致依赖冲突
多个微服务项目怎么共用一套调试配置？
每个微服务都是独立进程，但你在 VSCode 里不需要为每个服务单独写 launch.json。推荐用工作区文件（.code-workspace）统一管理。
立即学习“Python免费学习笔记（深入）”；
实操步骤：
• 在父目录（比如 microservices/）下新建 microservices.code-workspace
• 编辑该文件，填入：
{
"folders": [
{ "path": "auth-service" },
{ "path": "order-service" },
{ "path": "payment-service" }
],
"settings": {
"python.defaultInterpreterPath": "./.venv/bin/python"
}
}• 用 VSCode 直接打开这个
.code-workspace 文件，而不是单个文件夹
这样做的好处：
• 所有子项目共享同一套设置（比如 python.formatting.provider、python.linting.enabled）
• 调试时可跨服务设断点，launch.json 放在各自子目录下，VSCode 自动识别
• 避免因误开单个文件夹导致解释器切换失效
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
为什么 uvicorn 启动时报 “address already in use” 却找不到占用进程？
微服务本地联调时，多个 uvicorn 实例默认都监听 127.0.0.1:8000，端口冲突是常态。但 VSCode 终端关闭后，后台进程常残留——尤其在 Windows 上用 Ctrl+C 中断并不总能杀干净。
解决办法：
• 启动前加端口检查：在 launch.json 的 args 里显式指定端口，例如：["--host", "127.0.0.1", "--port", "8001"]
• 统一约定端口规划（如 auth=8000, order=8001, payment=8002）
• 查残留进程：
○ Windows：netstat -ano | findstr :8000 → 记下 PID → taskkill /PID <pid> /F</pid>
○ macOS/Linux：lsof -i :8000 → kill -9 <pid></pid>
? 提示：不要依赖 uvicorn 的 --reload 自动重启——它在多服务场景下容易触发竞态，建议开发阶段手动启停
如何让 VSCode 真正识别 pyproject.toml 里的依赖？
现代 Python 微服务普遍用 poetry 或 pip-tools 管理依赖，但 VSCode 的 Python 扩展默认只认 requirements.txt。结果就是类型提示失效、跳转报错、import 灰掉。
必须做三件事：
• 在项目根目录运行 poetry install（或 pip-compile && pip install -r requirements.txt），确保包装进 .venv
• 在 VSCode 设置里关掉 python.analysis.extraPaths 的错误路径（如有）
• 手动触发重载：按 Ctrl+Shift+P → 输入 Python: Restart Language Server
⚠️ 注意：
• Pylance 扩展必须启用，它是唯一能解析 pyproject.toml 中 [tool.poetry.dependencies] 的语言服务器
• 如果用 poetry，别在 .venv 外执行 poetry run —— VSCode 只认激活后的 .venv 路径
