docker desktop配置未生效的主因是修改后未触发wsl2重载或配置位置错误：file sharing需加盘符级路径并apply&restart，settings.json禁用utf-8 bom，volume路径须用绝对路径且确保进程完全重启。
改完配置后容器还是报错，大概率不是“改没改对”，而是“改完没生效”或“改的不是实际运行的那个配置”。Docker Desktop 的配置存在多层缓存和覆盖逻辑，直接编辑文件不等于容器立刻读取新值。
docker run -v 挂载路径在 Windows 上根本没被识别
Windows 用户执行 docker run -v C:\my\project:/app 后容器启动失败，错误常是 invalid argument 或直接退出。这不是语法错，是路径压根没进 WSL2 环境。
- 必须先在 Docker Desktop 设置里把
C:\或其父目录加入 File Sharing 白名单（Settings → Resources → File Sharing） - 白名单只认盘符或顶层路径，
C:\my不行，得加C:\或C:\Users - 加完要点击
Apply & Restart，不是点 OK 就完事——不重启，WSL2 里的/mnt/c/不会重建映射 - 验证是否生效：在 PowerShell 里运行
wsl -d docker-desktop -e ls /mnt/c/my/project，能列出文件才算通
settings.json 编码错误导致 Docker Desktop 启动就崩溃
修改镜像加速器、代理或实验性功能后 Docker Desktop 打不开，报错含 invalid character 'ï' looking for beginning of value，基本就是 settings.json 被保存成了 UTF-8 BOM 格式。
- Windows 记事本默认保存为 UTF-8 BOM，绝对不能用它改
$env:APPDATA\Docker\settings.json - 修复命令必须用 PowerShell 执行：
[System.IO.File]::WriteAllText($path, $content, (New-Object System.Text.UTF8Encoding $false)) - 改完别急着双击图标启动，先用任务管理器确认
Docker Desktop和com.docker.backend进程已完全退出 - 如果连 PowerShell 都卡在读取
settings.json，说明文件开头三个字节EF BB BF已损坏，只能手动删掉重写
docker-compose.yml 里 volumes 路径写对了但容器仍找不到文件
Compose 文件里写的是 volumes: - ./src:/app/src，本地 ./src 明明存在，容器内却提示 No such file or directory。
-
./src是相对路径，Docker Desktop 会按当前终端所在目录解析，不是按docker-compose.yml所在目录 - 必须用绝对路径，比如
- /c/Users/name/project/src:/app/src（WSL2 下对应/mnt/c/...） - 如果用了命名卷（
mydata:），要确认该卷没被旧容器独占：docker volume inspect mydata查Mountpoint是否可访问 - Windows 上通过
docker compose up启动时，Docker Desktop 会自动转换路径；但用docker-compose.exe（旧版 CLI）可能不转，得换用docker compose（v2 内置命令）
最常被忽略的一点：Docker Desktop 的设置界面改完配置后，很多项（尤其是 File Sharing、Proxies、Kubernetes）需要显式点击 Apply & Restart 才真正写入并触发 WSL2 重载。点完 OK 却没点 Apply，等于什么都没做。
