Stata的log命令一般时候可以不用，但是在结果展示、提交作业或者报告的时候，就很可能用得上了。因此，我们需要熟练掌握它。

log命令也称为日志功能，当我们启用后，可以把结果窗口中的内容完整保存到Stata专用的.smcl文档中。

Stata log命令有两大功能：

1. 日志功能，可以记录命令窗口的全部结果，并导出为txt或者PDF文档
2. 结果导出功能。有点类似于outreg2命令，且要相对更为灵活

接下来，本文分为相应两个部分展开说明。本文的重点是第一部分log的基础的日志功能。

一、log命令的日志功能

log系列命令的大致用法如下：

• log：查看目前log功能的状态
• log using：启用一个log文件，可以append也可以replace已有的log文档；如果没有该文件，则新建并启用。一般放在do的开头；同时使用多个log也是允许的
• log off/on：暂停使用log；继续启用log
• log close：log关闭。一般放在do最末尾
• set logtype：把log文件设置为smcl或者text格式
• set linesize #：设定log文件行的字数

下面我们结合具体案例进行演示以上命令。

1. log：查看目前log功能的状态

另外，log query _all命令，可以查看所以的log文件。

. clear all //将Stata全部内容清空. cd "D:0-data analysis" //更改工作目录
D:0-data analysis. use "D:0-data analysisdata1.dta", clear. log
(closed) //当前log功能未启用

我们启用log后再次查看：

. log using  log1, replace //创建并启用一个新的log文件log1name: <unnamed>
log:    D:0-data analysislog1.smcl
log type:   smcl
opened on:  22 Dec 2020, 14:13:34. log
name:   <unnamed>
log:    D:0-data analysislog1.smcl, on
log type:   smcl

2. log using：启用log文件

首先，Stata是可以同时启用多个log文档的，但是方法有些复杂，而且不常用。

本文在此介绍常用的启用单个log文档。对应的命令就是log using，它有两个重要的选项，一个是append，另一个是replace。

• 如果该文档已经存在，我们可以append到或者replace它
• 如果该log文档不存在，则新建并启用。一般放在do的开头

. log using log1, replace //创建并启用一个新的log文件log1
//如果文件已经存在，则取代原有文件. log using log1, append //启用原有的log文件log1
//将新的log内容append到log1

3. log on/of 暂时的开关

. log of //暂时关闭name:  <unnamed>log:  D:0-data analysislog1.smcllog type:  smclpaused on:  22 Dec 2020, 14:19:11. log on //继续启用
---------------------------------------------------------------------------------name:  <unnamed>log:  D:0-data analysislog1.smcllog type:  smcl
resumed on:  22 Dec 2020, 14:19:42

4. log close：log关闭。

对应的是log using，一般放在do最末尾。

使用 log close _all，可以关闭全部在用的log。

5. set logtype：把log文件设置为smcl或者text格式

. set logtype text,  permanently
(set logtype preference recorded)

虽说永久地改变了log的文档格式，但是不对当前使用的log文档起作用。只对后面新建的文档起作用。然而，我们不如在log using的时候，就直接指定log文档的格式。比如：

. log using log2.txt, repalce
(note: file D:0-data analysislog2.txt not found)
---------------------------------------------------------------------------------name:  <unnamed>log:  D:0-data analysislog2.txtlog type:  textopened on:  22 Dec 2020, 14:27:04

6. log set linesize #：设定log文件行的字数

但是要注意：linesize must be between 40 and 255，行的字数必须介于40~255之间。

二、log的导出功能

将分析结果，以出版级别的形式导出到Word等文档中，是Stata一个特别出色的功能。这一点，开源免费的R和Python就相对简陋。

1. 结合outreg2

log的导出，通常要结合其它命令，比如esttab和outreg2。其中outreg2功能最为强大，也是目前Stata数一受欢迎的命令（通过 ssc hot 命令查看。下回要写个文章专门剖析它才行）。

这里我们结合outreg2，展示log的导出功能。

注意：无需先启用log

log close
clear all //将Stata全部内容清空
cd "D:0-data analysis" //更改工作目录
outreg2 using out1.doc, replace sum(log) keep(weight length)  ///
eqkeep(N mean min p25 p50 p75 max sd) title(Descriptive statistics)

sum代表的是summarize命令。log用于记录sum命令返回的几个统计指标结果（这里的log，就指的是sum命令的结果记录）。导出的结果如下：

2. logout命令

问题又来了——logout命令和log命令有关系么？以下是logout的官方说明：

logout -- Converts log or ASCII files into various output formats

可见，两者还是有些关系的。不过，要记得的是，它们是两个独立的命令。

除了sum命令，logout还可以导出tab、table、esttab和regress等命令的结果。这里我们以sum和tabstat命令的结果为例。

首先，是用lougout命令导出sum命令的结果。

logout, save(logout1) word excel replace: sum weight length
//同时保存了logout1.xml和logout1.doc两个文档

接下来，是用logout命令导出tabstat命令的结果。

logout, save(logout1) excel replace: tabstat weight length, s(N mean p25 p50 p75 min max) col(s) format(%8.2f)

References

1. Stata 的log帮助文件

3.