WSL2映射Windows用户目录的跨平台通用路径变量问题

核心结论 #

WSL2本身没有原生的、无需自定义的跨平台路径变量能同时映射Windows用户目录并兼容Mac，但可以通过系统原生环境变量的条件写法实现无自定义配置的跨平台适配。

可行方案（无自定义变量） #

• 跨平台通用写法：在Docker Compose配置中使用${USERPROFILE:-${HOME}}作为路径占位符
  这个写法利用Shell参数扩展特性：
  • 在WSL2中，Windows的USERPROFILE环境变量会被自动导入，指向Windows用户目录的WSL格式路径（如/mnt/c/Users/MyUser）
  • 在Mac中，USERPROFILE不存在，会自动 fallback 到HOME（即Mac的~，指向用户主目录）
    示例配置：

  services:
    myapp:
      image: myapp-image
      volumes:
        - ${USERPROFILE:-${HOME}}/.config/myapp:/app/config
        - ${USERPROFILE:-${HOME}}/Documents:/app/docs
  

  这个方案完全依赖系统原生环境变量，不需要任何自定义配置或新增变量，适配WSL2和Mac的所有开发者环境。

关于早期~映射Windows目录的说明 #

早期WSL1的文件系统架构与WSL2不同，为了简化Windows与Linux环境的文件交互，默认将~指向Windows用户目录。但WSL2采用了独立的Linux虚拟机文件系统，为了提升文件访问性能和环境隔离性，官方将~改为指向WSL内部的主目录（如/home/MyUser），这是WSL版本迭代中的设计变更。

不推荐的方案 #

• 硬编码/mnt/c/Users/MyUser/：无法适配不同用户名的开发者，也不兼容Mac环境
• WSL专属路径/run/desktop/mnt/host/c/Users/$USER：仅适用于WSL2，无法跨平台

内容的提问来源于stack exchange，提问作者Levi Fuller