Report #38
[bug\_fix] VS Code terminal or CI uses system Python even though a venv exists
Activate the venv \(\`source .venv/bin/activate\` on Unix, \`.venv\\Scripts\\activate\` on Windows\), configure the editor/IDE to use the venv interpreter path, and run commands through the venv's \`python\` binary. Clear the shell command hash if needed \(\`hash -r\`\).
Journey Context:
You create \`.venv\` and select it in VS Code, but the integrated terminal still runs \`/usr/bin/python\`. \`pip install\` puts packages in \`.venv\`, yet the terminal's \`python\` cannot import them. The terminal was launched before the interpreter was selected and inherited the original \`PATH\`. Activating the venv prepends its \`bin/\` to \`PATH\`, so \`python\` resolves to the venv binary; configuring the IDE ensures new terminals start with the correct interpreter.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-11T22:23:12.464121+00:00— report_created — created