必须通过Remote-WSL插件显式进入WSL上下文（如执行“Remote-WSL: New Window”），确保左下角显示“WSL: Ubuntu”，终端为Linux提示符，项目置于/home/xxx而非/mnt/c，所有工具链（python3、pip、conda、gdb）均在WSL内安装配置。

VSCode 连接 WSL 写 Python，不是“装了插件就能跑”，关键在于是否真正在 Linux 环境里执行 python3、pip、conda 和调试器——否则你写的代码可能在 Windows 下能跑，但在真实 Linux 部署时直接报错。

Remote-WSL 插件启用后仍进不了 Linux 环境？

最常见现象：左下角状态栏没显示 WSL: Ubuntu-22.04，新建终端还是 PowerShell 或 cmd 提示符。这不是插件没装，而是没「显式进入」WSL 上下文。

• 别点「Open Folder…」再手动选 /mnt/c/Users/xxx/project ——这等于在 Windows 模式下打开，终端永远是 PowerShell
• 必须按 Ctrl+Shift+P，输入 Remote-WSL: New Window 回车；或点击左下角远程连接图标 → Open Folder in WSL
• 成功后窗口右下角明确显示 WSL: Ubuntu-22.04，资源管理器路径以 wsl$Ubuntu-22.04homeusername... 开头，终端提示符变成 username@hostname:~$
• 如果命令面板里搜不到 Remote-WSL，检查 VSCode 是 Windows 原生安装版（非 WSL 里 apt install code 装的旧版），且扩展已启用（不是灰色禁用）

项目放 /mnt/c/ 导致 pip install 失败、Git 权限报错？

/mnt/c/ 是 DrvFs 挂载的 Windows 文件系统，不支持 Linux 文件权限、符号链接、inotify 事件，I/O 性能差 5–10 倍。所有开发动作必须发生在 WSL 原生路径下。

• 项目根目录应放在 ~/projects/myapp 或 /home/username/src，而非 /mnt/c/Users/xxx/myapp
• 在 WSL 终端中进入该路径后执行 code .（前提是 VSCode 安装时勾选了 “Add to PATH”）
• 若需从 Windows 快速访问，用资源管理器地址栏输入 wsl$Ubuntu-22.04homeusernameprojects，不要反向操作
• 已在 /mnt/c/ 执行过 git clone 或 npm install？删掉重来，否则会持续遇到 unable to create file: Permission denied 或 ENOSPC

调试 Python 时提示 python3 not found 或找不到 conda 环境？

VSCode 调试器只读取 WSL 的 $PATH 和 shell 初始化文件（如 ~/.bashrc），但不会加载别名、函数，也不会跨系统复用 Windows 的 Python。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

立即学习“Python免费学习笔记（深入）”；

• 确保你在 WSL 中已安装 Python 3.x：python3 --version；没装就运行 sudo apt update && sudo apt install -y python3-pip python3-venv
• 用 conda？先在 WSL 中安装 Miniconda（推荐清华源），并确认 conda init bash 后重启终端，再运行 source ~/.bashrc
• VSCode 的 Python 扩展需手动指定解释器：按 Ctrl+Shift+P → Python: Select Interpreter → 浏览到 /home/username/miniconda3/bin/python 或 /usr/bin/python3
• 调试器启动失败？检查 launch.json 中的 python 字段是否指向 WSL 路径，例如 "python": "/home/username/miniconda3/bin/python"，而不是 Windows 的 C:\Users\xxx\AppData\Local\Programs\Python\Python311\python.exe

code . 在 WSL 终端里没反应？

这是 VSCode 未把 code 命令注入 WSL PATH 的典型表现，和 Remote-WSL 插件是否启用无关。

• 在 VSCode 中按 Ctrl+Shift+P，输入 Remote-WSL: Install Code Command in PATH 并执行
• 执行后关闭当前 WSL 终端，新开一个（或运行 source ~/.bashrc），再试 code .
• 验证：在 WSL 终端中运行 which code，应输出类似 /home/username/.vscode-server/bin/xxxxxx/bin/code
• 如果提示 command not found 且 Install Code Command in PATH 不可用，说明 VSCode 版本太低（需 ≥1.35），或 Remote-WSL 扩展被禁用

真正麻烦的从来不是连不上，而是连上了却没意识到自己还在 Windows 路径里敲命令、装包、改权限——这些隐性错位，往往要等到部署到服务器才爆发。每次打开 VSCode，先看一眼右下角是不是 WSL: xxx，再看一眼终端提示符是不是 user@host:~$，比查文档快十倍。