WSL2阻止Windows10下VSCode编辑/保存文件的原因及解决方法

问题原因 #

• 卸载不彻底：通过「应用和功能」卸载WSL2时，未清理残留的用户目录、权限配置等文件，重装后新实例与旧残留文件的权限规则冲突，导致VSCode远程保存时触发权限拒绝。
• 错误执行chmod 777：该命令会递归修改目标路径下所有文件的权限，中途终止操作可能导致部分系统文件或WSL挂载的Windows文件权限混乱，进一步加剧权限问题。
• WSL组件关联异常：重装过程中WSL核心组件与Ubuntu发行版的关联未正确建立，导致「应用和功能」无法识别对应的卸载项。

解决办法 #

1. 修复VSCode远程保存权限问题 #

进入WSL Ubuntu环境，重置用户主目录权限：

• 打开PowerShell，执行wsl -d ubuntu进入Ubuntu实例
• 执行以下命令（将your_username替换为你的Ubuntu用户名）：

  sudo chown -R $USER:$USER /home/$USER
  

  该命令会将主目录下所有文件、文件夹的所有者重置为当前用户，解决核心权限拒绝问题。

2. 彻底卸载并重装WSL2（解决无法卸载的问题） #

若权限问题仍存在，或需要清理所有残留配置：

• 停止所有WSL实例：

  wsl --shutdown
  

• 彻底注销Ubuntu发行版（会删除该实例的所有数据）：

  wsl --unregister ubuntu
  

• 卸载WSL核心组件：打开「应用和功能」，找到「适用于Linux的Windows子系统」和「虚拟机平台」，点击卸载。
• 重新安装WSL2：打开管理员权限的PowerShell，执行：

  wsl --install -d ubuntu
  

  等待安装完成后，重新设置Ubuntu用户名和密码。

3. 清理错误chmod导致的Windows文件权限混乱 #

如果之前的chmod命令修改了WSL挂载的Windows文件（如/mnt目录下的文件），可在Windows系统中操作：右键点击对应文件夹，选择「属性」-「安全」-「高级」，点击「重置所有子对象的权限并允许传播可继承权限」，确认应用即可。

内容的提问来源于stack exchange，提问作者Candy Hi