本文作者：陈志林，河南大学经济学院

本文编辑：喻淑敏

技术总编：李婷婷

▼导读▼

log 命令的用法大致如下：

1、log及其子命令

报告日志文件的状态：log

生成并打开日志文件：log using filename [, append replace [text|smcl] name(logname) nomsg]

关闭日志：log close [logname | _all]

暂停或恢复日志记录：log {off|on} [logname]

通过log 及其子命令可以打开一个日志文件，并创建一个日志，记录键入的内容和输出的结果。其默认生成的文件格式为SMCL，也可以是纯文本格式，建议大家使用SMCL，因为它可以保留字体和颜色。

2、cmdlog及其子命令 

报告命令日志文件的状态：cmdlog

打开命令日志文件：cmdlog using filename [, append replace]

关闭或继续或暂停命令日志文件：cmdlog {close|on|off}

cmdlog 及其子命令类似于log 命令，都能够打开、暂停或继续记录日志，但是cmdlog命令创建一个命令日志只是记录输入的内容，并不对输出结果进行记录，且只能是纯文本文件。  

接下来我们介绍一下这两个命令的相关选项。

选项append 和replace 均适用于log 和cmdlog ，功能如下：

• append 指定将结果追加到现有文件中。

• replace 指定文件名，如果它已经存在，将会被替换。

• text 和 smcl 指定记录日志的格式。
• name(logname) 表示可以生成并打开一个日志文件，并对该日志进行自定义命名。（注意不是日志文件名称哦）。
• nomsg 隐藏显示在日志文件顶部和底部的默认信息。

另外这两个命令都是有返回值的，r(name)可以返回日志的名称、r(filename)返回日志的文件名、r(status)返回日志的状态是打开还是关闭等等。

我们通过几个简单例子来具体感受一下log 的日志功能吧。

1、日志文件的打开与关闭

我们首先打开一个log文件。

此时Stata中显示的结果如下：

这里表示在默认路径下新建一个log1日志文件，也可以直接指明其路径。其中using不仅表示新建，也表示打开日志文件。对于文件有replace 和append 两种情况，接下来我们分别展开这两个方式。

首先我们来看一下使用replace 选项的情况：

Stata输出窗口和log1日志文件中显示的结果分别如下：

运用log 命令可以让我们很方便地将操作过程和输出结果都完整无误地记录并保存下来。  

接下来我们继续看一下使用append 选项的情况：

此时log1文件中所显示的结果如下图所示：

可以看出，使用append 这一选项是在原有的log1日志文件中继续记录的。  

再补充一下name选项的用法吧！当我们想要给这个日志定义一个名称时，可以采用以下命令：

这时窗口中显示的结果如下

我们可以看到其日志名为被定义为了“Log2”。

2、日志文件的暂停与恢复

有时候我们在运行时会夹杂一些与整个程序无关的的一些命令，但是我们并不想在日志中记录这些过程，我们应该怎样操作呢？off 与on 可以很好地完成这一任务。  

首先我们执行以下程序：

Stata结果窗口和log1文件中的结果分别如下：

3、cmdlog命令日志文件的记录

为突显log 与cmdlog 命令之间的区别，我们依然采用类似于3.1和3.2中的操作命令。程序如下：

Stata中结果窗口和cmdlog1文件中显示的内容分别为下图所示：

4、返回值

上文已经提到了log的返回值，在这里我们列举一个小例子来简单看一下吧！  

我们执行以下命令来将log的返回值r(name)读入到变量中：

显示结果为：

其实log命令还有很多巧妙的用处，比如之前在我们的答疑群中也有小伙伴提出这样的一个小问题，即Stata的输出结果已经占满了整个Stata窗口，但是想查看之前的输出内容。

通过我们以上的介绍，相信大家已经猜到解决思路啦！yeah! 就是我们这篇文章介绍的log日志功能咯，赶快动手将自己的命令操作和结果记录下来吧！

腾讯课堂课程二维码