推荐WSL2+Ubuntu并用Remote-WSL插件直连，代码存于WSL内部路径，终端设为Ubuntu Shell，确保工具链、权限、调试均在Linux环境运行。
在Windows上用VSCode配合WSL，确实能实现接近原生Linux的开发体验——关键不是装上就完事，而是把路径、终端、调试和文件系统这几环真正串起来。
WSL环境要选对，推荐WSL2 + Ubuntu
WSL1兼容性好但无完整Linux内核，跑Docker或需要systemd的服务会受限；WSL2基于轻量虚拟机，支持完整内核功能，IO性能也已大幅优化。安装时直接从Microsoft Store下载Ubuntu（如22.04），避免手动导入旧版镜像。装好后运行wsl --update确保内核最新，并用wsl --set-version Ubuntu-22.04 2确认是WSL2。
VSCode远程开发：用Remote-WSL插件直连
别在Windows里开VSCode再打开WSL路径——那样走的是Windows文件系统，权限、换行符、符号链接都会出问题。正确做法是：在WSL终端中执行code .，VSCode会自动拉起Remote-WSL扩展，在WSL环境中启动一个专用窗口。此时所有任务、调试、终端都运行在Ubuntu里，/home/username就是真实路径，npm install、gcc编译、Python venv全按Linux逻辑走。
将图片上传至 img402.dev，以便嵌入 GitHub PR、Issue 和评论中。免费套餐（最大 1MB，保留 7 天，无需身份验证）为默认选项；付费套餐支持最大 5MB，并可通过 x402 实现 1 年（
别在Windows里开VSCode再打开WSL路径——那样走的是Windows文件系统，权限、换行符、符号链接都会出问题。正确做法是：在WSL终端中执行code .，VSCode会自动拉起Remote-WSL扩展，在WSL环境中启动一个专用窗口。此时所有任务、调试、终端都运行在Ubuntu里，/home/username就是真实路径，npm install、gcc编译、Python venv全按Linux逻辑走。
.01）或永久（）保留。当智能体需要在 GitHub 场景中分享图片时使用——例如截图、原型图、流程图，或其他任何视觉内容。触发条件包括：“截图当前页面”、“附加一张图片”、“将截图添加到该 PR 中”、“上传此原型图”，或任何生成需用于 GitHub 的图片的任务。终端与默认Shell要统一配置
VSCode内置终端默认可能还是Windows PowerShell。进设置搜terminal integrated default profile，设为Ubuntu-22.04。再检查WSL里的~/.bashrc或~/.zshrc是否已配置好alias、PATH和常用工具（比如export PATH="$HOME/.local/bin:$PATH"）。这样Ctrl+`新开终端，就是干净可用的Ubuntu shell。
文件存放位置有讲究
- 项目代码放WSL内部：比如/home/username/projects/myapp，避免跨系统读写导致权限丢失或git报错
- 不要直接编辑/mnt/c/下的文件：虽然能访问，但NTFS无Linux权限模型，chmod/chown无效，ssh key、git hooks、node_modules都容易出问题
- VSCode设置可同步到WSL：在Remote-WSL窗口里修改settings.json，它会存到~/.vscode-server/data/Machine/settings.json，下次连接自动生效
基本上就这些。不复杂但容易忽略——核心就一条：让代码、工具链、终端、配置全部落在WSL文件系统里，VSCode只做“透明窗口”。其他都是顺带的事。
