fix(api): 修复 Windows Git Bash 下 API 路径被 MSYS2 污染导致 404 #406

chroe · 2026-07-09T23:38:36+08:00

chroe commented

2026-07-09 23:38:36 +08:00

问题

在 Windows Git Bash (MSYS2) 环境下执行：
gitlink-cli api GET /v1/owner/repo
路径参数会被 MSYS2 自动改写为类似
C:/Program Files/Git/v1/owner/repo
（MSYS2 把 /v1 当成 Unix 路径，转换为 Git 安装目录），导致 API 调用 404。
影响所有 Windows Git Bash 用户。

修复

在 cmd/api 的 runAPI 中检测路径首部是否为盘符（^[A-Za-z]:/），
若是则按常见 API 前缀（/v1/ /v2/ /api/ /users/ /projects/）定位并还原原始 API 路径。

改动仅 +15 行，不影响其他平台行为。

## 问题在 Windows Git Bash (MSYS2) 环境下执行： gitlink-cli api GET /v1/owner/repo 路径参数会被 MSYS2 自动改写为类似 C:/Program Files/Git/v1/owner/repo （MSYS2 把 /v1 当成 Unix 路径，转换为 Git 安装目录），导致 API 调用 404。影响所有 Windows Git Bash 用户。 ## 修复在 cmd/api 的 runAPI 中检测路径首部是否为盘符（^[A-Za-z]:/），若是则按常见 API 前缀（/v1/ /v2/ /api/ /users/ /projects/）定位并还原原始 API 路径。改动仅 +15 行，不影响其他平台行为。

chroe added 2 commits 2026-07-09 23:38:37 +08:00

b0424aa6d8 fix(api): restore API path polluted by MSYS2/Git Bash on Windows

在 Windows Git Bash (MSYS2) 环境下，gitlink-cli api GET /v1/owner/repo
的路径参数会被 MSYS2 自动改写为类似
C:/Program Files/Git/v1/owner/repo 的 Windows 路径（MSYS2 把 /v1
当成 Unix 路径转换为 Git 安装目录），导致 API 调用 404。

修复：在 runAPI 中检测路径首部是否为盘符（^[A-Za-z]:/），
若是则按常见 API 前缀（/v1/ /v2/ /api/ /users/ /projects/）
定位并还原原始 API 路径。

影响所有 Windows Git Bash 用户，跨平台兼容性修复。

bf9ecc4ba2 docs(api): add MSYS2 path fix doc; extract restoreAPIPath for testability

- 新增命令帮助文档 doc/changes/api-msys2-path.md（问题/根因/修复/影响/测试）。
- 将 runAPI 内联的路径还原逻辑抽成纯函数 restoreAPIPath，便于单元测试；
  并修正一个边界缺陷：路径含多个已知前缀时（如 /api/v1/users）改为取
  最早出现的位置，避免误截到 /v1/。
- 新增表驱动 TestRestoreAPIPath 覆盖：正常路径不变、v1/v2/api 污染还原、
  无已知前缀保留、空路径。

wbtiger referenced this issue from a commit

2026-07-14 22:02:41 +08:00

Merge pull request #406: fix(api): 修复 Windows Git Bash 下 API 路径被 MSYS2 污染导致 404

wbtiger referenced this issue from a commit

2026-07-14 22:02:41 +08:00

fix(api): restore resolveAPIPath after MSYS2 merge conflict resolution

wbtiger closed this pull request

2026-07-14 22:03:51 +08:00

wbtiger reopened this pull request

2026-07-14 23:03:32 +08:00

wbtiger closed this pull request

2026-07-14 23:09:06 +08:00