fix: 修复 Dev Container 中 .gitconfig 注入路径问题，改为挂载临时路径并在创建阶段复制

Author: shijiashuai

.devcontainer/devcontainer.json

@@ -13,7 +13,7 @@
     "overrideCommand": true,
     "mounts": [
         "type=bind,source=${localEnv:HOME}/.ssh,target=/home/developer/.ssh,readonly",
-        "type=bind,source=${localEnv:HOME}/.gitconfig,target=/home/developer/.gitconfig,readonly",
+        "type=bind,source=${localEnv:HOME}/.gitconfig,target=/tmp/host-gitconfig,readonly",
         "type=bind,source=${localEnv:SSH_AUTH_SOCK},target=/ssh-agent"
     ],
     "remoteEnv": {
@@ -23,7 +23,7 @@
     "forwardPorts": [
         8080
     ],
-    "postCreateCommand": "bash -lc \"if [ -z \\\"${WSL_DISTRO_NAME:-}\\\" ]; then echo 'WARNING: 建议使用 VS Code Remote - WSL 在 WSL2 中打开仓库，再执行 Reopen in Container（更稳定/更快/更一致）。' >&2; fi; if [ ! -S /ssh-agent ]; then echo 'WARNING: 未检测到 SSH agent 注入（/ssh-agent 不存在）。若需要访问私有仓库，请在 WSL 中执行：eval \\\"$(ssh-agent -s)\\\" && ssh-add，然后 Rebuild/Reopen。' >&2; fi; git config commit.template .gitmessage.txt || true; conan profile detect --force >/dev/null 2>&1 || true\"",
+    "postCreateCommand": "bash -lc \"cd /workspace || exit 0; if [ -z \\\"${WSL_DISTRO_NAME:-}\\\" ]; then echo 'WARNING: 建议使用 VS Code Remote - WSL 在 WSL2 中打开仓库，再执行 Reopen in Container（更稳定/更快/更一致）。' >&2; fi; if [ ! -S /ssh-agent ]; then echo 'WARNING: 未检测到 SSH agent 注入（/ssh-agent 不存在）。若需要访问私有仓库，请在 WSL 中执行：eval \\\"$(ssh-agent -s)\\\" && ssh-add，然后 Rebuild/Reopen。' >&2; fi; if [ -d /home/developer/.gitconfig ]; then sudo rm -rf /home/developer/.gitconfig; fi; if [ -f /tmp/host-gitconfig ]; then cp -f /tmp/host-gitconfig /home/developer/.gitconfig; fi; if git rev-parse --is-inside-work-tree >/dev/null 2>&1; then git config commit.template .gitmessage.txt || true; else echo 'WARNING: /workspace 不是 Git 仓库，跳过 git config commit.template。' >&2; fi; conan profile detect --force >/dev/null 2>&1 || true\"",
     "customizations": {
         "vscode": {
             "settings": {

.devcontainer/devcontainer.simple.json

@@ -8,7 +8,19 @@
     "workspaceFolder": "/workspace",
     "remoteUser": "developer",
     "overrideCommand": true,
-    "postCreateCommand": "bash -lc \"git config commit.template .gitmessage.txt || true; conan profile detect --force >/dev/null 2>&1 || true\"",
+    "mounts": [
+        "type=bind,source=${localEnv:HOME}/.ssh,target=/home/developer/.ssh,readonly",
+        "type=bind,source=${localEnv:HOME}/.gitconfig,target=/tmp/host-gitconfig,readonly",
+        "type=bind,source=${localEnv:SSH_AUTH_SOCK},target=/ssh-agent"
+    ],
+    "remoteEnv": {
+        "SSH_AUTH_SOCK": "/ssh-agent",
+        "WSL_DISTRO_NAME": "${localEnv:WSL_DISTRO_NAME}"
+    },
+    "forwardPorts": [
+        8080
+    ],
+    "postCreateCommand": "bash -lc \"cd /workspace || exit 0; if [ -z \\\"${WSL_DISTRO_NAME:-}\\\" ]; then echo 'WARNING: 建议使用 VS Code Remote - WSL 在 WSL2 中打开仓库，再执行 Reopen in Container（更稳定/更快/更一致）。' >&2; fi; if [ ! -S /ssh-agent ]; then echo 'WARNING: 未检测到 SSH agent 注入（/ssh-agent 不存在）。若需要访问私有仓库，请在 WSL 中执行：eval \\\"$(ssh-agent -s)\\\" && ssh-add，然后 Rebuild/Reopen。' >&2; fi; if [ -d /home/developer/.gitconfig ]; then sudo rm -rf /home/developer/.gitconfig; fi; if [ -f /tmp/host-gitconfig ]; then cp -f /tmp/host-gitconfig /home/developer/.gitconfig; fi; if git rev-parse --is-inside-work-tree >/dev/null 2>&1; then git config commit.template .gitmessage.txt || true; else echo 'WARNING: /workspace 不是 Git 仓库，跳过 git config commit.template。' >&2; fi; conan profile detect --force >/dev/null 2>&1 || true\"",
     "customizations": {
         "vscode": {
             "settings": {

changelog/2026-01-08-devcontainer-windows.md

@@ -11,6 +11,7 @@
   - 增加对 WSL2 打开方式的校验：要求通过 VS Code Remote - WSL 打开工作区后再 Reopen in Container。
   - 增加 SSH/Git 自动注入：挂载宿主机（WSL）侧 `~/.ssh` 与 `~/.gitconfig`，并转发 `SSH_AUTH_SOCK`。
   - 将 WSL2/SSH 校验由“强制失败”调整为“仅提示”（warning），避免将工作流规定写死为硬阻断。
+  - 修复 `.gitconfig` 注入导致容器内路径变成目录的问题：改为挂载到临时路径并在创建阶段复制到用户目录；同时避免在非 Git 仓库目录执行 `git config` 报错。
 - `scripts/devcontainer_setup.sh`：修复在 `set -u` 模式下引用未定义环境变量（`GIT_USER_NAME` / `GIT_USER_EMAIL`）导致脚本退出的问题。
 - 文档：新增 `docs/dev/devcontainer-guidelines.md` 作为团队 Dev Container 开发规范，并在 `README.md` / `docs/README.md` 中增加入口链接。