VSCode连接WSL后python3报错，是因为终端未真正进入WSL环境；需通过Ctrl+Shift+P执行Remote-WSL: New Window或点击左下角远程连接图标显式切换。
VSCode 连接 WSL 后，python3 命令仍报错？先确认是否真在 Linux 环境里执行
很多人装完 Remote-WSL 插件就以为“连上了”，结果终端还是 PowerShell 或 cmd，python3 --version 直接提示 command not found。这不是 Python 没装，而是 VSCode 根本没进 WSL 上下文。
必须通过以下任一方式显式进入：
- 按
Ctrl+Shift+P→ 输入Remote-WSL: New Window→ 回车 - 点击左下角远程连接图标（>Open Folder in WSL
- 在已启动的 WSL 终端中，cd 到项目目录后运行
code .（前提是 Windows 版 VSCode 安装时勾选了 “Add to PATH”）
成功后，窗口左下角明确显示 WSL: Ubuntu-22.04，资源管理器路径以 wsl$Ubuntu-22.04homeusername 开头，终端提示符是 username@hostname:~$ —— 只有这时，你敲的每条命令才真正跑在 Linux 里。
项目放 /mnt/c/ 下，pip install 总失败？立刻迁移到 ~/ 原生路径
/mnt/c/ 是 Windows 文件系统（DrvFs）挂载点，不支持 Linux 权限、符号链接、inotify 事件，I/O 性能差 5–10 倍。所有开发动作放这里，必踩坑：
立即学习“Python免费学习笔记（深入）”；
-
pip install报Permission denied或unable to create file -
git clone失败，或后续git status显示大量文件被修改（权限位乱） -
conda activate后环境变量不生效，调试时找不到包
正确做法：
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
- 把项目根目录放在
~/projects/myapp或/home/username/src - 在 WSL 终端中
cd ~/projects/myapp后再运行code . - Windows 端想快速访问？资源管理器地址栏输入
wsl$Ubuntu-22.04homeusernameprojects，别反向操作
想用 conda 虚拟环境，但 VSCode 找不到？关键在 conda init 和 shell 重载
WSL 中装好 Miniconda 后，VSCode 调试器只读取 $PATH 和 shell 初始化文件（如 ~/.bashrc），但不会加载别名、函数，也不会复用 Windows 的 conda。
常见问题和解法：
- 安装 Miniconda 时，最后一步提示
Do you wish to initialize Miniconda3?→ 必须输yes，否则conda命令根本不可用 - 安装完必须关闭当前终端，重新打开一个 WSL 终端（让
~/.bashrc生效），再运行conda --version验证 - 创建并激活环境：
conda create -n myenv python=3.11→conda activate myenv - 在 VSCode 中按
Ctrl+Shift+P→Python: Select Interpreter→ 从列表选~/miniconda3/envs/myenv/bin/python（路径要完整）
如果列表里没出现你的环境，说明 conda init bash 没成功，或没重启终端——不是插件问题，是 shell 环境没加载。
运行 Python 脚本时提示 python3 not found？检查解释器路径和 shebang 行
即使 VSCode 左下角显示了正确的 conda 环境（如 (myenv):conda），运行脚本仍可能失败，原因常被忽略：
- 脚本第一行写了
#!/usr/bin/env python：Linux 下python通常指向 Python 2，而 WSL 默认只有python3；应改为#!/usr/bin/env python3或#!/usr/bin/env python3.11 - VSCode 的运行配置（
launch.json）里指定了错误的python路径，比如写成"python": "python"而非"python": "./.venv/bin/python"（对 venv）或完整 conda 路径 - 终端里手动运行
python3 script.py成功，但 VSCode 的「Run Python File」按钮失败 → 检查右下角解释器是否真的切换成功（有时显示对了，但实际没 reload）
最稳的方式：在 VSCode 终端里手动激活环境（conda activate myenv），再运行 python3 script.py。能跑通，说明环境没问题；跑不通，才是路径或权限问题。
