如何在本地版Azure DevOps Wiki中创建指向同项目GIT仓库文件的链接

针对Wiki页面关联同项目Git仓库内Word文档这类特定对象的跳转需求，当前最新版本本地部署的Azure DevOps原生就支持实现，不需要额外安装第三方插件，具体可落地的操作方法如下：

方法一：用内置链接选择器直接关联目标文件 #

这是最不容易出问题的操作方式，全程不需要手动拼接路径：

• 打开需要编辑的Wiki页面，选中要设置超链接的目标文本
• 点击编辑器工具栏的「插入链接」按钮，在弹出的选项列表中选择「从仓库选择」
• 在资源选择面板中，定位到同项目下的目标Git仓库，依次选定目标分支、仓库内对应路径下的Word文档等对象，确认后系统会自动生成可正常访问的跳转链接

补充说明：通过该方式生成的链接，会自动适配当前本地部署实例的访问规则，跳转后直接打开文件预览页，Word、PDF等格式的文件可直接在线预览，不需要手动触发下载。

方法二：手动拼接标准格式的仓库文件链接 #

如果需要快速插入链接、不想打开选择器操作，可以按照系统内置的路径规则手动编写，标准格式为：
/{组织名称}/{项目名称}/_git/{目标仓库名称}?path=/{文件在仓库内的完整存储路径}
举个实际场景的参考：当本地部署的组织名为fabrikam，目标项目名为fabrikam-cn，关联的Git仓库名为product-docs，需要跳转的文件是仓库/legal-contracts路径下的2024供应商合作协议.docx，最终可直接使用的链接地址为：
/fabrikam/fabrikam-cn/_git/product-docs?path=/legal-contracts/2024供应商合作协议.docx
如果需要把链接固定到特定分支的文件版本，避免后续分支内容更新导致跳转内容变更，可以在链接末尾追加分支指定参数，调整后的格式为：
/{组织名称}/{项目名称}/_git/{目标仓库名称}?path=/{文件路径}&version=GB/{目标分支名称}

实操注意事项 #

• 权限逻辑和仓库直访完全一致：只要访问Wiki的用户本身拥有对应Git仓库的读取权限，就能通过生成的链接正常打开目标文件，不需要额外配置跳转权限
• 手动拼链接时需要注意路径大小写匹配，文件路径参数path值的开头必须加斜杠，否则会触发404页面
• 不建议手动填写带有公网域名的绝对路径，本地部署环境下这类路径容易出现域名不匹配的访问错误，优先使用相对路径格式

内容的提问来源于stack exchange，提问作者GaryFurash