Stata编程:暂元local和global的使用技巧

👇 连享会 · 推文导航 | www.lianxh.cn

🍓 课程推荐：连享会 · 2026寒假嘉宾：连玉君 (中山大学)；郭士祺（上海交通大学）时间：2026 年 1 月 28 - 2 月 9 日咨询：王老师 18903405450（微信）

 做一个好的学术论文，有三个要求：

• 一是技能，包括 Stata 软件怎么用，怎么处理数据，编程，可视化，初级班可以完美解决大家的这一步；
• 二是方法，比如说怎么处理非线性关系，怎么说清楚内生性问题与样本选择等。在这一部分，老师的提点十分重要。高级班的内容就是针对这一步，通过复现论文，带着大家学习同一种方法在不同场景下是怎么变形落地，从而把关键假设与证据写的更稳
• 三是道，就是说写论文讲的什么故事，用的什么idea。

技能与方法都是为“道”服务，一篇好的论文，不仅仅是用好的方法，更是要用这些好的方法去讲好这个故事。论文班就是在讲这个。

作者：陈云菲 (上海大学)邮箱：cyfyeya17863928515@163.com

温馨提示： 文中链接在微信中无法生效。请点击底部「阅读原文」。或直接长按/扫描如下二维码，直达原文：

编者按：本文主要参考自下文，特此致谢！

• Cox N J. Stata tip 138: Local macros have local scope[J]. The Stata Journal, 2020, 20(2): 499-503. -PDF-
• Herrin J. Stata tip 77:(Re) using macros in multiple do-files[J]. The Stata Journal, 2009, 9(3): 497-498. -PDF-

目录

• 1. 暂元的定义

• 2. 暂元 (macros) 家族

• 3. 暂元 (macros) 使用技巧

• 3.1 全局暂元 (global macros)

• 3.1 局部暂元 (local macros)

• 3.3 取长补短的 include 命令

• 4. 相关推文

在使用 Stata 运算时，每个人或多或少都曾遇到过变量繁多、程序复杂，让人眼花缭乱，以及不断做重复性步骤，降低工作效率。其实，Stata 中的暂元 (macros) 以有效解决这些问题。接下来，我们将从暂元 (macros) 的定义、种类、使用技巧和注意事项等几个方面做一个梳理，以帮助大家快速了解暂元。

1. 暂元的定义

暂元 (macros)，顾名思义可解释成“暂时的元素”。暂元就像一个“盒子”，我们可以把需要的内容放进不同的“盒子” (暂元 macros) 里，然后做好标记 (给每一个暂元 macros 取一个新的名字)，运行命令时直接调用“盒子”的名字，Stata 就可以自动识别并提取。“盒子”里的内容可以是字符串、数字、变量、返回值，甚至可以是暂元 (macros)。

2. 暂元 (macros) 家族

全局暂元 (global macros)：“永久性盒子”，在 Stata 关闭之前将一直存在。局部暂元 (local macros)：“一次性盒子”，每一次使用都需要重新定义，并且只在选中的局部代码块中有效。运行包含局部暂元 (local) 的多行命令时，需要同时执行，否则会报错。

全局暂元 (global) 和局部暂元 (local) 二者互有优劣，include 命令可以结合二者的优势。本文将从这三个部分出发，揭开暂元 (macros) 神秘的面纱。

3. 暂元 (macros) 使用技巧

3.1 全局暂元 (global macros)

作为永久性盒子，全局暂元 (global macros) 一旦被定义，那么就可以在全局被调用，包括：

• 直接在命令窗口中输入命令
• 运行整个 do 文件或 do 文件中的某段代码
• 编写的程序 (program)

定义全局暂元 (global) 的基本命令为：

global name "value"

其中，name 为全局暂元 (global) 的名称，value 为全局暂元 (global) 储存的内容。调用全局暂元 (global) 的命令为 $暂元名称。下面我们运用 Stata 自带的 1978 汽车数据集 auto.dta 来检验此命令。

. sysuse auto, clear. * 将表示汽车特征的一组变量放入全局暂元 size 中. global size " weight length trunk displacement ". regress price $size      Source |       SS           df       MS      Number of obs   =        74-------------+----------------------------------   F(4, 69)        =      9.22       Model |   221276728         4  55319182.1   Prob > F        =    0.0000    Residual |   413788668        69  5996937.22   R-squared       =    0.3484-------------+----------------------------------   Adj R-squared   =    0.3107       Total |   635065396        73  8699525.97   Root MSE        =    2448.9------------------------------------------------------------------------------       price | Coefficient  Std. err.      t    P>|t|     [95% conf. interval]-------------+----------------------------------------------------------------      weight |      4.649      1.412     3.29   0.002        1.831       7.466      length |   -102.309     43.083    -2.37   0.020     -188.259     -16.360       trunk |     27.899     97.905     0.28   0.777     -167.416     223.215displacement |      0.616      7.026     0.09   0.930      -13.401      14.633       _cons |  10850.978   4628.016     2.34   0.022     1618.338   20083.619------------------------------------------------------------------------------

当 Stata 看到 $size 时，将会把“盒子”里的内容替换到命令中，最后输出结果。因此，Stata 实际运行的命令是  regress price weight length trunk displacement。再举一个将命令返回值存储到全局暂元 (global) 中的例子，假设我们想要得到变量的中位数，我们可以这样做：

. sum price, detail                            Price-------------------------------------------------------------      Percentiles      Smallest 1%         3291           3291 5%         3748           329910%         3895           3667       Obs                  7425%         4195           3748       Sum of wgt.          7450%       5006.5                      Mean           6165.257                        Largest       Std. dev.      2949.49675%         6342          1346690%        11385          13594       Variance        869952695%        13466          14500       Skewness       1.65343499%        15906          15906       Kurtosis       4.819188. * 将中位数的值存储到全局暂元 median_price 中. global median_price = r(p50) . display "$median_price"5006.5

作为一个“盒子”，如果将里面的内容替换掉，当 Stata 再次调用它的时候也会自动更新。听起来似乎不错，但全局暂元 (global) 全局有效的特点，有时候会导致严重错误。如果替换“盒子”里面的内容，可能会导致调用相同名字但存放内容不同的暂元出现问题。为避免这种错误，定义太多不同名字的暂元又会造成另一种复杂性。局部暂元 (local) 的出现弥补了这种不足。

3.1 局部暂元 (local macros)

作为一次性盒子，局部暂元 (local macros) 在 do 文件中只能执行一次，执行过后会释放暂元内容，下次使用时需要重新定义，并且在其他的 do 文档或者同一 do 文档其他代码块中无法识别。定义局部暂元 (local) 的基本命令为：

local name "value"

其中，name 为局部暂元 (local) 的名称，value 为局部暂元 (local) 储存的内容。调用局部暂元 (local) 的命令为 `暂元名称'。其中，左侧为 Tab 键上方反引号，右侧为 Enter 键左边单引号。以 1978 汽车数据集 auto.dta 为例：

. sysuse auto, clear. local size "weight length trunk displacement" // 定义局部暂元 size. regress price `size'                          // 回归分析      Source |       SS           df       MS      Number of obs   =        74-------------+----------------------------------   F(4, 69)        =      9.22       Model |   221276728         4  55319182.1   Prob > F        =    0.0000    Residual |   413788668        69  5996937.22   R-squared       =    0.3484-------------+----------------------------------   Adj R-squared   =    0.3107       Total |   635065396        73  8699525.97   Root MSE        =    2448.9------------------------------------------------------------------------------       price | Coefficient  Std. err.      t    P>|t|     [95% conf. interval]-------------+----------------------------------------------------------------      weight |      4.649      1.412     3.29   0.002        1.831       7.466      length |   -102.309     43.083    -2.37   0.020     -188.259     -16.360       trunk |     27.899     97.905     0.28   0.777     -167.416     223.215displacement |      0.616      7.026     0.09   0.930      -13.401      14.633       _cons |  10850.978   4628.016     2.34   0.022     1618.338   20083.619------------------------------------------------------------------------------

再次强调，运行包含局部暂元的多行命令时，需要同时选中执行该代码块，否则会失效或报错。比如，我们先运行定义局部暂元的命令，然后再运行回归命令。

. local size "weight length trunk displacement" // 先运行这一行命令. regress price `size'                          // 再运行这一行命令      Source |       SS           df       MS      Number of obs   =        74-------------+----------------------------------   F(4, 69)        =      9.22       Model |   221276728         4  55319182.1   Prob > F        =    0.0000    Residual |   413788668        69  5996937.22   R-squared       =    0.3484-------------+----------------------------------   Adj R-squared   =    0.3107       Total |   635065396        73  8699525.97   Root MSE        =    2448.9------------------------------------------------------------------------------       price | Coefficient  Std. err.      t    P>|t|     [95% conf. interval]-------------+----------------------------------------------------------------      weight |      4.649      1.412     3.29   0.002        1.831       7.466      length |   -102.309     43.083    -2.37   0.020     -188.259     -16.360       trunk |     27.899     97.905     0.28   0.777     -167.416     223.215displacement |      0.616      7.026     0.09   0.930      -13.401      14.633       _cons |  10850.978   4628.016     2.34   0.022     1618.338   20083.619------------------------------------------------------------------------------

此时，局部暂元已经失效，在 Stata 中相当于命令 regress price，即汽车价格对常数项进行回归。尽管有了全局暂元 (global) 和局部暂元 (local)，有研究者提出了新的问题：如果只想在某几个 do 文件里面使用暂元，并非永久的全局性也非临时的局部性，怎么办呢？Stata 中提供了 include 命令来解决这个问题。

3.3 取长补短的 include 命令

include 命令可以实现将指定的 do 文件内容插入命令行位置以取代该命令行，从而将指定的文件和当前的源程序文件连成一个源文件。include 命令的调用方法 include "文件名"。下面我们仍然运用 Stata 自带的 1978 汽车数据集 auto.dta 来检验此命令。

首先，我们建立一个 do 文件，命名为 locals.do，并在该 do 文件中定义 size1 和 size2 两个局部暂元。

* 生成 locals.do 文件，并保存local size1 " weight length "local size2 " trunk displacement "

然后，利用 include 命令调用上述暂元。

. sysuse auto, clear . include locals.do. local size1 " weight length ". local size2 " trunk displacement ". regress price `size1' `size2'      Source |       SS           df       MS      Number of obs   =        74-------------+----------------------------------   F(4, 69)        =      9.22       Model |   221276728         4  55319182.1   Prob > F        =    0.0000    Residual |   413788668        69  5996937.22   R-squared       =    0.3484-------------+----------------------------------   Adj R-squared   =    0.3107       Total |   635065396        73  8699525.97   Root MSE        =    2448.9------------------------------------------------------------------------------       price | Coefficient  Std. err.      t    P>|t|     [95% conf. interval]-------------+----------------------------------------------------------------      weight |      4.649      1.412     3.29   0.002        1.831       7.466      length |   -102.309     43.083    -2.37   0.020     -188.259     -16.360       trunk |     27.899     97.905     0.28   0.777     -167.416     223.215displacement |      0.616      7.026     0.09   0.930      -13.401      14.633       _cons |  10850.978   4628.016     2.34   0.022     1618.338   20083.619------------------------------------------------------------------------------

如果想要修改内容，直接在 locals.do 中进行修改，再次调用时，Stata 会读取新的内容。在程序设计中，include 命令非常有用，将一些常用的符号或变量单独命名成一个 do 文件，避免每次都重新编写，节省时间，并减少出错。因此，include 实现了可以在多个 do 文件中同时调用不同全局暂元 (global) 和局部暂元 (local) 功能。

🍓 课程推荐：连享会-TFP专题：估计、识别与分解嘉宾：董展育 (中山大学)；李旭超 (武汉大学)时间：2026 年 1 月 10, 11, 17 日咨询：王老师 18903405450（微信）