作者：游萬海 || 連玉君

目錄

Stata 軟件的一大特點是其開放性。用戶可以修改 Stata 官方提供的命令 (其實就是一些以 .ado 為后綴的文本文件)，為己所用。同時，全球的 Stata 用戶也在日夜耕耘，共享他們編寫的新命令——外部命令，比如大家熟悉的 outreg2 (Roy Wada)，estout (Ben Jann) 和 winsor2 (Lian Yu-jun ) 等熱門命令。

遺憾的是，這些外部命令分散在互聯(lián)網(wǎng)的各個角落，我們需要一些海納百川的本領。這就是本文地主要目的：大家介紹外部命令的搜索、安裝及使用方法。

大家在演示教材中的例子時，經(jīng)常發(fā)現(xiàn)為何相同的命令，教材可以得到結果，而自己運行卻出現(xiàn)錯誤，如最常見是扎眼的紅色信息 command fuzzydid is unrecognized

常用的外部命令來源：

• Statistical Software Components (SSC) archive (http://www.)
• Stata Journal ( https://www./)
• Stata Technical Bulletin (STB) (https://www./products/stb/)
• github (https://github.com/)

一些最熱門的命令：

輸入 ssc hot, n(10) 可以查看 SSC 上最熱門的 10 個命令：

輸入 github hot, number(5) 可以查看 Github 上最熱門的 5 個命令。

1. 路徑設置

為了方便命令的管理，下面先介紹一些基本的設置。

下載的外部命令通常為 .ado 格式，為了將下載的命令與自編的命令放在不同的路徑下，找到 Stata 的安裝路徑，可以看到一個 【ado 】文件夾。里面有【base】 文件、【plus】 文件及 【personal】 文件（后兩個文件夾不一定有自帶，可以自己手動創(chuàng)建）。

• 【base】文件夾用于存儲 Stata 自帶的基礎命令
• 【plus】文件夾用于存儲外部命令
• 【personal】用于存儲自己編寫的命令和 dofiles。

為了達到這一目的，需要對系統(tǒng)默認路徑進行一些簡單的設置。在 Stata 的安裝路徑下（如：【D:\stata15】）新建一個 profile.do 文件，將如下命令放到此文件中：

（Note: 連老師在這里-連玉君的 profile.do 文檔 分享了他的 profile.do 文檔。https:///arlionn/StataProfile ）

2. 外部命令的下載

根據(jù)外部命令的來源不同，所使用的命令也不盡一致，這里主要介紹 ssc ， search，net ，findit 和 github 等命令。

2.1 ssc 命令

ssc 是 Statistical Software Components (http://www.) 的縮寫，用于操作存放在該網(wǎng)站上的外部命令，包括安裝 ( ssc install)、移除 ( ssc uninstall )、描述 ( ssc describe)、顯示最近更新 ( ssc new )、顯示最熱門 ( ssc hot )。例如：

. ado dir  //顯示已安裝ado文件
[1] package outreg2 from http://fmwww./repec/bocode/o
      'OUTREG2': module to arrange regression outputs into an illustrative table
[2] package estout from http://fmwww./repec/bocode/e
      'ESTOUT': module to make regression tables

. ssc install winsor2, all replace   //安裝winsor2，基本用法：ssc install newprogramname
checking winsor2 consistency and verifying not already installed...
installing into D:\stata15\ado\plus\...
installation complete.

若要查看某一具體命令是否安裝，可以利用

要查看 ssc 上最熱門的命令，可以通過

. ssc hot, n(10)  //顯示排名前10的命令
Top 10 packages at SSC
        Aug 2018   
  Rank   # hits    Package       Author(s)
  ----------------------------------------------------------------------
     1  331271.0    findname      Nicholas J. Cox                         
     2  19504.6    outreg2       Roy Wada                                
     3  18223.6    estout        Ben Jann                                
     4  11066.7    distinct      Gary Longton, Nicholas J. Cox           
     5   7746.3    winsor        Nicholas J. Cox                         
     6   6881.7    winsor2       Lian Yu-jun                             
     7   6598.7    ivreg2        Mark E Schaffer, Steven Stillman,  Christopher F Baum                      
     8   6579.3    ivreg210      Mark E Schaffer, Steven Stillman, Christopher F Baum                      
     9   6571.1    ivreg28       Mark E Schaffer, Steven Stillman,  Christopher F Baum                      
    10   6561.8    ivreg29       Christopher F Baum, Mark E Schaffer, Steven Stillman                         
  ----------------------------------------------------------------------
  (Click on package name for description)

從上面結果可以看出，連老師編寫的 winsor2 也榜上有名 (^^此處應有掌聲)。另外，還有 ssc new , ssc describe , ssc type 和 ssc copy 等用法，具體可以通過 help ssc 查看相關例子。

2.2 search 命令

相比于 ssc 命令，search 搜索的范圍更廣，該命令語法如下：

word 表示待搜索的關鍵詞，比如想了解面板數(shù)據(jù)模型的相關命令，可以 search panel data model。對于怎么取關鍵詞，可以 help searchadvice。可以看出，搜索結果中既有 Stata 手冊中的命令，也有外部命令，甚至還包括 Stata 官方的培訓、書籍、視頻和 FAQ 等信息。

search 命令的選項 search_options 主要包括：all，net，faq，manual，sj 等，對應上文提到的各種類型的信息，以便于我們實現(xiàn)精準搜索。

search + all

通常為默認選項，根據(jù)幫助文件的描述：

search, all is the best way to search for information on a topic across all sources, including the system help, the FAQs at the Stata website, the Stata Journal,and all Stata-related Internet sources including user-written additions

從上面的表述可以發(fā)現(xiàn)，當定義 all 時，其搜索范圍很廣，包括軟件自帶的系統(tǒng)文件，Stata 網(wǎng)站的常見問題集，Stata journal 期刊及其他網(wǎng)絡相關資料。因此，與 ssc 不同，search 命令不僅可以搜索外部命令，也能搜索其他相關文檔資料。

search + net

search + net 與 net search 等價，幫助文件中的介紹如下：

net search searches the Internet for user-written additions to Stata, including, but not limited to, user-written additions published in the Stata Journal (SJ) and in the Stata Technical Bulletin (STB)
從上述描述可知，通過該命令可以搜索發(fā)布在 Stata Journal (SJ) 和Stata Technical Bulletin (STB)上的相關資料。資料不僅包括 ado 命令 文件，還包括幫助文件 (help files) 和數(shù)據(jù)集 (datasets).

• (3) search + sj: 僅搜索 Stata Journal 和 Stata Technical Bulletin 上的資源。
• (4) search + faq: 僅搜索到發(fā)布在 Stata 官網(wǎng) http://www. 中的 FAQS 條目下的資源。
• (5) search + manual: 僅搜索 Stata 電子手冊文檔上的資源。 例子：

. search linear regression, all
. search linear regression, net
. search linear regression, sj
. search linear regression, faq
. search linear regression, manual

連享會計量方法專題……

2.3 net 命令

net 命令的用法與 search 相似，功能也較多，詳細可以 help net 查看。本文主要介紹以下幾種：

• (1) net search word [word ...] [, search_options]該命令與上面介紹的 search + net 等價；
• (2) net install語法如下：

該命令可以用于從特定的網(wǎng)站安裝外部 ado 文件，比如

.net install github, from('https://haghish./github/')

運行上述命令得到

使用 ado describe 命令可以查看已安裝命令詳情：

. ado describe github

--------------------------------------------------------
[4] package github from https://haghish./github
--------------------------------------------------------

TITLE
      'GITHUB': search, install, and uninstall Stata packages with a particular    {break}

DESCRIPTION/AUTHOR(S)
      version (release) as well as their dependencies from
      {browse 'http://www.github.com/haghish/github':GitHub} website
      Distribution-Date: 20161214
INSTALLATION FILES
      f\findall.ado
      f\findall.sthlp
      g\github.ado
      g\github.dlg
      g\github.sthlp
      g\githubcheck.ado
      g\githubconfirm.ado
      g\githubdependency.ado
      g\githublist.ado
      g\githubmake.ado
      g\githuboutput.ado
      g\githubquery.ado
      g\githubsearch.ado
      g\githubsearchsteps.ado
      m\make.ado
      m\make.dlg

INSTALLED ON
      1 Nov 2018
--------------------------------------------------------

• (3) net sj vol-issue [insert]這個用法很強大，有時候我們想把 Stata Journal 某一期所涉及的外部命令都下載到本地，比如想安裝 2018年第 3 期文中的所有文件，可以使用如下命令：

這等價于

. net from 'http://www./software/sj18-3'

2.4 findit 命令

findit + keyword 等價于 search keyword [keyword ...], all

可以搜索的資料包括： 系統(tǒng)文件 the system help, the FAQs, the Stata Journal, and all Stata-related Internet sources including user-written additions. 如我們想了解 Stata 中有關面板單位根檢驗方面命令與資料，可以執(zhí)行如下命令：

2.5 github命令

gitHub 是一個面向開源及私有軟件項目的托管平臺，因為只支持 git 作為唯一的版本庫格式進行托管，故名 gitHub。在 GitHub 中，用戶可以十分輕易地找到海量的開源代碼。

目前，越來越多學者將程序托管到該平臺，包括 Python，R 和 Stata 等各種軟件。為了更方便地安裝托管在github 上的命令，E. F. Haghish 開發(fā)了 github 命令。github 可以實現(xiàn)搜索、安裝、移除等功能。

為了使用這一外部命令，首先要通過以下命令進行安裝

. net install github, from('https://haghish./github/')

完成 github 安裝，通過 help github，可以發(fā)現(xiàn)其語法如下

這里主要介紹 github search 和 github install：

• (1) github search: 該命令可以對托管到 github 平臺的 Stata 相關命令進行搜索，比如我們想知道在 github 平臺上有哪些面板數(shù)據(jù)模型相關命令，可以輸入：

. github search panel data model, in(all)

根據(jù)上面返回的結果，點擊相應藍色部分的命令可以在 github 上查看相應的項目，包括：倉庫、作者主頁等，點擊 Install 可以在線安裝該命令的相關文件。

• (2) github install: 該命令主要用于安裝托管于 github 平臺的外部命令。比如我們想了解在 Stata 中是否有實現(xiàn)動態(tài)報告的相關命令(類似于 R 里面的 knitr 包)，可以輸入命令

此時，點擊 Install 會自動安裝最新版本，若想安裝此前的某個版本，則可以使用 github install 命令的 version() 選項加以控制：

. github install haghish/MarkDoc , version('3.8.0')

之后在界面上可以看到

這也是發(fā)布于 github 上的命令區(qū)別于 SSC 上的命令的主要區(qū)別：Github 可以非常高效地進行版本控制。

3. 總結

可將本部分內(nèi)容歸結為兩點：

• 其一，當知道外部包的具體命令寫法時，通常可以利用 ssc install, net install ，github install 等命令直接安裝；
• 其二，若只知道該命令的大體功能或關鍵詞，而不知道具體名稱，可以通過 findit，search，github search 等命令進行搜索，在返回的結果中查找安裝。
• 其三，為了保證外部命令能夠被 Stata 自動檢索到，需要在 profile.do 文檔中設定文件路徑。