WDF:文件管理工具包介绍

在日常科研与生活中，文件的管理是一项重复且费神的工作。例如在使用 Stata 过程中经常需要切换工作路径或对某一路径下的文件进行处理。今天将介绍三组文件管理工具包：workingdir、dirtools与fileutils（取首字母，简记为 WDF），都是有效实现文件管理的利器。

1. WDF 工具包的安装

WDF 工具包可以通过下面的代码进行安装：

//网速较慢的时候可能需要多试几次才能成功安装
net install workingdir, from("http://www.indiana.edu/~jslsoc/stata")replace
ssc install dirtools,replace
ssc install fileutils, replace

在安装完成后，WDF 工具包下分别集成了如下的命令：

• workingdir: adoit 、 browseit、 doit 、dtait、 editit、 dropcd 、listcd 、makecd 、savecd
• dirtools: lall、 ldo、 ldta 、lsmcl、 lgph、 ltex 、lado 、lmata、 lpdf、 leps、 cdout、 clickout
• fileutils: go、 pushd 、popd (go 命令运行较容易出错，本文暂不介绍)

下面将通过实例来介绍 WDF 工具包的相关内容。

2. workingdir 工具包的介绍

2.1 dta/do/ado 文件的管理

2.1.1 dta文件管理：dtait 与 browseit 命令

dtait 命令用来列示并通过点击打开当前路径下的所有dta文件，browseit则是列示并通过 点击打开 Stata 数据浏览器。

. dtait
nhanes2.dta

上述命令执行后在列示当前工作路径下的dta文件的同时，每个dta文件还会附带蓝色链接，如图所示：

点击蓝色链接，可以将该数据集读入内存，相当于执行如下的操作：

use nhanes2.dta, clear  

而点击browseit 命令产生的蓝色链接，则打开数据浏览器:

. browseit
nhanes2.dta

2.1.2 do/ado 文件管理：doit、adoit、 editit

• doit 命令会列示当前工作路径下的所有 do文件，点击 蓝色链接会执行do文件:

. doit
无标题.do 

• adoit 则列示当前工作路径下的所有ado文件，同样支持点击-执行ado文件的操作
• editit 列示当前路径下的所有do文件与ado文件，并通过点击进行do文件与ado文件的编辑工作。

. editit
mysepreg.ado
无标题.do

2.2 文件路径的管理：savecd 与 listcd 命令

• savecd 命令用来保存文件路径，方便快速切换到该工作路径。
  例如，Stata 需要 经常在 d:\data下工作，那么就可以用savecd保存这一路径，而无需经常切换，代码如下：

. cap mkdir d:\data //在d盘根目录下生成一个data文件夹
. cd d:\data
d:\data
. savecd s //将该工作路径命名为s并保存
command cds saved in your PERSONAL directory

这样就在PERSONAL文件夹下通过生成cds.ado文件存储了该工作路径，以后如果想切换到该路径，在 Stata 命令框输入cds即可。特别是当原来的文件路径较长时，较为方便。此外，还可以通过savecd命令的note选项对工作路径进行补充说明，通过replace选项覆盖原来保存的工作路径。

• listcd 命令用来列示当前工作路径下保存的cd路径文件，并对该文件进行相应处理：
  

. listcd
 cds  d:/data/ - drop
. cds //如上图，点击左侧的蓝色链接 cds切换到目标路径
d:\data
. dropcd cds //如上图，点击右侧的蓝色链接 drop ，删除该保存路径(将文件的扩展名由ado改为hold)
cds.ado renamed cds.hold

//退出Stata,再次执行 listcd,发现默认的工作路径下已经不存在cd*.ado文件
. listcd 
. 

3. dirtools 工具包的介绍

• lall命令是 ldo、 ldta 、lsmcl、 lgph 、lmata 等命令的综合，分别列示当前工作路径下的 do、 dta、 smcl、 gph、 mata等文件。下面的代码列示了d:\data文件夹下的不同类型的文件。

//通过命令窗口输入 cds 进入 d:\data 文件夹。
//为方便展示，事先在d:\data文件夹下准备了实例性文件。
cds
. lall //lall命令有erase选项，该选项将会删除工作路径的所有文件，应谨慎使用。
Data files
 [des] [describe] [use]  nhanes2.dta 
Click [here] for other links
Do-files
 [view] [edit] [do]  deaprog.do 
 [view] [edit] [do]  无标题.do 
Click [here] for other links
Graphs
 [display] [print] [toeps]  jianshao4.gph 
Click [here] for other links
SMCL-files
Click [here] for other links

根据上面的代码，对于dta文件有 des、 describe（详细描述）及use（读入内存）等三种操作，对于do文件有 view（查看）、 edit（编辑）、 do（运行）等操作，对于gph文件（图片）文件有 display（展示）、print(打印)及toeps(转换为eps格式的图片)等操作。上述操作都可以通过点击蓝色链接实现。

• lpdf:快速打开 PDF 文档
  下面的代码列示了d:\data文件夹下的 PDF 文件，并且可以通过点击每个 PDF 文档之前的 [open]链接打开对应的 PDF 文档：

. lpdf
 [open] [print] [tops]  long-doit-commands-2018-08-08.pdf 
 [open] [print] [tops]  long-working-directory-2018-08-10.pdf 

• ltex:在 Stata 中打开LaTeX文件。该命令实现了在 Stata 中查看与编辑 tex文件。
• clickout:快速打开文件。该命令会列示当前路径的所有文件及链接，实现迅速打开的目的。
  代码如下：

cds //进入d:\data文件夹
. clickout //返回d:\data下的所有文件及链接
deaprog.do
jianshao4.gph
long-doit-commands-2018-08-08.pdf
long-working-directory-2018-08-10.pdf
nhanes2.dta
outputst.ado
无标题.do
第2部分.tex

• cdout:打开当前工作路径。

4. one more thing:文件路径的跳转与返回

有时在处理数据时需要临时跳转工作路径，然后经过一系列的操作之后，再返回原来的工作路径。这一操作可以通过pushd与popd命令完成。下面通过一个实例演示该命令的用法：

• 代码如下：

. cds   //进入d:\data文件夹
d:\data
. pushd "d:\下载" //临时跳转进入"d:\下载"文件夹
d:\下载
. popd   //返回到初始文件路径
d:\data

以上主要介绍了workingdir与dirtools两个文件管理工具包，包括不同类型文件的管理、文件夹路径的保存与调用等问题，最后简略地介绍了fileutils工具包，用以实现文件路径的跳转与返回等问题。上面介绍的命令熟练掌握后，势必会提高大家的文件管理技巧。