✍️ 田冬冬 , 姚家园 , 陈箫翰 • 📅 2026-01-16

# which

官方文档:

  which

简介:

  返回指定文件的完整路径，将远程数据下载到本地

该模块会报告文件的完整路径，使得用户可以确认自己在使用的究竟是哪个数据文件。

GMT 会依次在如下目录中去寻找命令行中指定的文件： 当前目录 > GMT 用户目录 > GMT 数据目录 > GMT 缓存目录。 可以参考 输入文件的搜索目录 了解每个目录的具体指定方式。

另一个用途是使用 `-G` 选项，将 GMT 数据服务器上的远程数据下载到本地。

## 语法

gmt which files [ `-A` ] [ `-C` ] [ `-D` ] [ `-G`[a|c|l|u] ] [ `-V`[level] ] [ --PAR=value ]

## 必选选项

files

  任意一个或多个数据文件名

## 可选选项

-A

-A

  仅考虑用户有读权限的文件 [默认不考虑权限问题]

-C

-C

  不报告完整路径，只打印 Y 或 N 以表示是否找到文件

-D

-D

  不报告完整路径，仅打印包含该文件的目录名

-G

-G[a|c|l|u]

  自动下载指定的文件。指定下载文件的方式有：

  - URL 链接形式指定的文件：下载到当前目录

  - @filename 形式指定的文件：从 GMT 数据服务器上下载到缓存目录

  - @earth_relief_xxy 形式指定的文件（即 GMT 提供的地学数据集）： 从 GMT 数据服务器上下载到用户目录下的 `server` 子目录

  使用该选项时，GMT 会先按照 输入文件的搜索目录 中指定的搜索顺序寻找文件， 若未找到文件，才会尝试下载该文件：

  - -Gl： 下载到当前目录 [默认选项]

  - -Ga： 下载到用户目录的子目录中，如 `server`、`cache` 子目录

  - -Gu： 下载到数据目录

  - -Gc： 下载到缓存目录

-V

-V[level]

  设置 verbose 等级 [w]。 (参数详细介绍)

-^ 或 -

  显示简短的帮助信息，包括模块简介和基本语法信息（Windows下只能使用 -）

-+ 或 +

  显示帮助信息，包括模块简介、基本语法以及模块特有选项的说明

-? 或无参数

  显示完整的帮助信息，包括模块简介、基本语法以及所有选项的说明

--PAR=value

  临时修改GMT参数的值，可重复多次使用。参数列表见 配置参数

## 示例

查看某个文件的路径:

    gmt which myjunk.txt

下载并返回GMT提供的10分精度的全球地形起伏数据:

    gmt which -Ga @earth_relief_10m

从GMT数据服务器下载GMT示例数据。该数据会被下载到GMT缓存目录中（默认为 `~/.gmt/cache`）:

    gmt which -Gc @hotspots.txt