核心是用 VSCode Remote-WSL 在纯净 WSL2 环境中开发：项目放 Linux 文件系统、工具链原生安装、调试和 Git 全部走 WSL 原生能力，禁用 Windows 版自动更新与跨文件系统写入。
用 VSCode + WSL 做 Linux 开发，核心是让编辑、调试、构建都在真实 Linux 环境里跑，同时享受 VSCode 的图形化体验和 Windows 的生态便利。关键不是“能用”，而是“顺、稳、少踩坑”。
WSL 环境要轻量且纯净
推荐使用 WSL2（非 WSL1），它有完整的 Linux 内核、更好的文件系统性能和 Docker 支持。安装时直接从 Microsoft Store 下载 Ubuntu 22.04 或 24.04，避免用第三方打包镜像或升级内核——官方镜像最稳。
- 禁用 Windows 自动更新 WSL：在 PowerShell 中运行 wsl –update –skip-download，再加 wsl –set-default-version 2
- 把项目放在 Linux 文件系统里（如 /home/username/project），别放 /mnt/c/ 下——跨文件系统读写慢，还可能触发权限或换行符问题
- 用 sudo apt update && sudo apt upgrade -y 更新后，精简预装包（比如删掉 snap、云镜像服务），减少后台干扰
VSCode 连接要走 Remote-WSL 扩展
别用 Windows 版 VSCode 直接打开 wsl$Ubuntuhome… 路径——那是 SMB 挂载，不支持调试器、终端集成和文件监听。必须安装官方 Remote – WSL 扩展，然后从 WSL 内启动 VSCode。
- 在 WSL 终端中运行 code .（确保已执行 code –install-server 首次配置）
- VSCode 窗口左下角会显示 WSL: Ubuntu，此时所有任务（终端、调试、Git、扩展）都原生运行在 Linux 中
- 推荐禁用 Windows 版 VSCode 的自动更新，只更新 Remote-WSL 扩展本身，避免版本错配导致连接失败
开发工具链要对齐 Linux 原生路径
编译器、Python 解释器、Node.js、CMake 等，全部从 WSL 内安装，不要复用 Windows 的 PATH。VSCode 的 settings.json 中明确指定路径，避免“找不到 gcc”或“Python 解释器选错”这类低级错误。
- 例如 Python 项目：在工作区设置里加 “python.defaultInterpreterPath”: “/usr/bin/python3”
- C/C++ 项目：用 C/C++ Configurations 设置 compilerPath 为 /usr/bin/gcc，并生成 c_cpp_properties.json 时选 WSL 环境
- 终端默认设为 bash（不是 PowerShell），并在 settings.json 中配置 “terminal.integrated.defaultProfile.linux“: “bash”
调试和 Git 要利用好 WSL 原生能力
GDB、LLDB、Python Debugger、Node Debugger 全部调用 WSL 里的二进制，所以断点、变量查看、内存检查都真实可靠。Git 同理——用 WSL 里的 git，而非 Windows Git for Windows，避免换行符（CRLF/LF）冲突和权限位丢失。
- 在 WSL 中执行 git config –global core.autocrlf input（Linux 项目统一用 LF）
- 调试 C++ 时，确保编译加 -g -O0，launch.json 中的 program 路径写绝对路径（如 /home/user/myapp/build/app）
- 如果需要访问 Windows 文件（比如测试数据），用 /mnt/c/Users/xxx/data，但只读取，不写入；写操作一律留在 Linux 文件系统
基本上就这些。不复杂，但容易忽略路径、权限、启动方式三个关键点。只要 WSL 是干净的、VSCode 是远程连进去的、工具链是 Linux 原生的，剩下的就是写代码了。
