如何通过Artifactory的downloadBranch API下载含隐藏文件的VCS分支？

我之前在使用Artifactory的VCS downloadBranch API时也碰到过完全一样的问题——默认确实会跳过.gitignore这类点开头的隐藏文件。好在有几种方法可以解决这个问题，分享给你：

方法1：使用API的includePatterns参数强制包含所有文件 #

Artifactory的downloadBranch API支持通过includePatterns参数指定要包含的文件模式，我们可以用这个参数匹配所有文件（包括隐藏文件）。

修改你的curl命令，添加includePatterns参数：

curl -XGET "https://artifactory.domainname.com/artifactory/api/vcs/downloadBranch/your-repo-key/your-target-branch?includePatterns=**" -o branch-full.zip

这里的**是通配符，匹配所有层级的所有文件。如果需要更精确的匹配（比如单独指定隐藏文件），也可以写成：

curl -XGET "https://artifactory.domainname.com/artifactory/api/vcs/downloadBranch/your-repo-key/your-target-branch?includePatterns=**/.*,**/*" -o branch-full.zip

这个模式会同时匹配所有隐藏文件（**/.*）和普通文件（**/*）。

方法2：直接通过Artifactory文件归档API下载分支内容 #

如果方法1不生效，你可以绕开VCS专属的downloadBranch API，直接使用Artifactory通用的文件归档功能。VCS仓库的分支内容在Artifactory中会以your-vcs-repo/branches/your-branch-name的路径存储，你可以直接打包下载这个路径下的所有内容：

curl -XGET "https://artifactory.domainname.com/artifactory/your-vcs-repo/branches/your-target-branch?archive=zip" -o branch-full.zip

这种方式会直接打包该路径下的所有文件，包括隐藏文件，因为它是基于Artifactory存储的实际文件列表操作的。

额外检查：确保隐藏文件已同步到Artifactory #

如果上面两种方法都拿不到隐藏文件，那可能是Artifactory同步VCS仓库时就忽略了这些文件。你需要：

• 登录Artifactory后台，找到你的VCS仓库配置
• 检查同步设置中的Exclude Patterns，确认没有添加.gitignore或.*这类排除规则
• 如果有排除规则，删除后重新触发VCS同步，确保隐藏文件被同步到Artifactory中

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