用途
本技能用于解决在 Windows 上通过 Git Bash（MINGW）或 MSYS2 运行 Docker 命令时，因 MSYS/MINGW 自动路径转换而引发的卷挂载错误。典型症状包括：Docker 报错“bind source path does not exist”并附带 C:\Program Files\Git\ 前缀，或容器内挂载目录为空。技能提供检测、修复和验证的完整方法。
主要能力
- 解释路径转换的触发条件：参数以 / 开头、冒号分隔的路径列表（/foo:/bar）、- 或 , 后跟路径组件。
- 说明豁免转换的情况：含 = 的参数、盘符（C:）、含 ; 的参数、以 // 开头的参数。
- 提供多种解决方案：
- MSYS_NO_PATHCONV=1（Git Bash 推荐），可逐命令前缀或全局导出。
- MSYS2_ARG_CONV_EXCL（MSYS2 专用），支持通配符排除。
- 双斜杠前缀（//c/Users/project），无需环境变量，在 Linux 上可移植。
- 使用 $(pwd) 并正确转义，避免使用 $PWD。
- 提供函数包装器，自动为每个 docker 命令禁用路径转换。
- 给出 docker run 与 docker-compose.yml 的最佳实践：命名卷无路径问题，Compose 相对路径可直接使用。
- 提供环境检测脚本（检查 MSYSTEM 或 uname -s）和测试脚本，验证卷挂载是否正常。
- 列出无需修改即可工作的命令（命名卷、网络、镜像、无卷容器、Compose 相对路径）和需要修复的命令（绝对路径绑定挂载、$(pwd) 绑定挂载、命令行卷挂载）。
使用方式
- 检测环境：在 Git Bash 中检查 $MSYSTEM 或 uname -s 是否包含 MINGW。
- 选择方案：
- 推荐在 ~/.bashrc 中添加 export MSYS_NO_PATHCONV=1。
- 或使用函数包装器：docker() { (export MSYS_NO_PATHCONV=1; command docker.exe "$@"); } export -f docker。
- 或对单条命令加前缀：MSYS_NO_PATHCONV=1 docker run -v $(pwd):/app myimage。
- 或使用双斜杠：docker run -v //c/Users/project:/app myimage。
- 编写 Compose 文件时使用相对路径（./src:/app/src）或命名卷，无需特殊处理。
- 运行测试脚本验证配置是否生效。
适用场景
- 在 Windows 的 Git Bash 中使用 Docker 进行本地开发，需要绑定挂载源代码或配置文件。
- 使用 docker run 命令行挂载卷，尤其是包含绝对路径或 $(pwd) 时。
- 使用 docker compose 但需要在命令行覆盖卷挂载。
- 排查“No such file or directory”或挂载目录为空的问题。
限制
- 主要针对 Git Bash（MINGW）和 MSYS2，不适用于 WSL 或原生 Linux/macOS。
- 双斜杠方案可读性较差，容易遗忘。
- 路径中包含空格时仍需额外引号处理，建议避免项目路径含空格。
- 技能未提供关于收费、价格、平台支持范围或性能效果的信息。