如何让Azure DevOps Wiki识别文件夹内的同名现有页面?
解决Azure DevOps Git Wiki文件夹跳转同名文件的问题
核心办法:利用Wiki的默认页面规则
Azure DevOps Git Wiki支持将文件夹下的同名Markdown文件设为文件夹的默认打开页,但得匹配它的识别规则:
- 文件名必须严格对应:比如文件夹叫
Deployment,里面的文件就得是Deployment.md,后缀必须是.md,格式不对的话Wiki不会识别。 - 确认文件在默认分支上:Wiki默认读取的是你配置的主分支(一般是
main或master),PR合并后得确保文件已经同步到这个分支,不然Wiki找不到文件,就会跳转到添加页面的提示。
无需添加特殊内容,只需调整文件配置
不需要在Markdown文件里加任何额外代码或元数据,满足以下两点即可:
- 文件夹和同名MD文件处于同一层级(比如
/Docs/Deployment/Deployment.md,不能把文件放到文件夹的子目录里)。 - 确保文件没被Git忽略,且已经成功推送到Wiki关联的Git仓库中。
常见问题排查
- PR合并后刷新缓存:Azure DevOps Wiki偶尔会有缓存,合并PR后手动刷新页面,或者等待几分钟让Wiki同步仓库内容。
- 检查权限:确认当前用户拥有该仓库的读取权限,没有权限的话Wiki加载不了文件,就会提示添加页面。
- 注意文件名大小写:Git在Windows环境下可能不区分大小写,但Wiki对大小写是严格识别的,得保证文件夹名和文件名的大小写完全一致(比如
deployment文件夹对应deployment.md,别写成Deployment.md)。
内容的提问来源于stack exchange,提问作者MattyMatt
相关产品推荐
相关产品推荐

