作者：萬莉 (北京航空航天大學)
?

連享會 - 與君分享 lianxh.cn

文章目錄

• • 引言
  • 1. 什么是 Atom ？
  • 2. Atom 的安裝
  • • • 連享會計量方法專題……
  • 3. Atom + Stata
  • • 3.1 第一種方法：Language-Stata + Stata-exec
    • • 第一步：安裝 `language-stata`
      • 第二步：安裝 `stata-exec`
      • 連享會計量方法專題……
    • 3.2 第二種方法：Hydrogen + Language-stata + Stata_kernel
  • 4. Atom 小技巧和 FAQs
  • • 4.1 Atom 使用小技巧
    • • Tip1： 顯示左側(cè)側(cè)邊欄
      • Tip2：Atom 的漢化
    • 4.2 Atom 設(shè)定常見問題 (FAQs)
  • 5. 結(jié)語
  • • 相關(guān)鏈接
    • • 關(guān)于我們

引言

我們可以借助外部編輯器編寫并運行 dofile，從而提高輸入效率和語法高亮功能。那我們可以選擇哪些外部編輯器呢？

參考「Stata+Sublime：美觀高效的dofile編輯器」和「珠聯(lián)璧合：Jupyter Notebook 與 Stata 之融合」，我們可以選用 Sublime 和 Jupyter Notebook。相較 Sublime，Jupyter Notebook 能使運行的結(jié)果直接顯示在代碼下方，更方便查看。

本文將介紹 Atom 這一編輯神器——被開發(fā)團隊稱為“一個為 21 世紀所創(chuàng)造的可配置編輯器 (A hackable text editor for the 21st Century)”。通過下載相應(yīng)插件 (Package)，我們既能實現(xiàn) Stata + Sublime 的效果，也能實現(xiàn) Stata + Jupyter Notebook 的效果。

我們先看看效果圖 （安裝插件 Hydrogen、language-stata 和 Stata Jupyter kernel），是不是很炫酷！

?

1. 什么是 Atom ？

Atom 是一個免費的跨平臺編輯器，已在 GitHub 上開放了全部源代碼。它擁有非常精致細膩的界面和豐富的可配置項。

它提供了與 SublimeText 類似的 Package Control (包管理)功能。我們可以非常方便地安裝、管理各種插件，并將 Atom 打造成真正適合自己的開發(fā)工具。

最大的亮點是，該編輯器由 GitHub（目前全球范圍內(nèi)影響力最大的代碼倉庫/開源社區(qū)） 打造，有著很大的發(fā)展?jié)摿Αｉ_源社區(qū)非常非常活躍，能及時解決各種問題。

?

2. Atom 的安裝

• 方法一
  在官網(wǎng)上 Atom 直接點擊 Download，便可下載最新版本。注意：缺點是雙擊 exe 文件便直接安裝在 C 盤，無法自定義安裝路徑。

• 方法二
  在官網(wǎng)上 Atom 點擊 Other platforms 或者打開 https://github.com/atom/atom/releases，根據(jù)自己的系統(tǒng)，選擇對應(yīng)的壓縮包。該壓縮包為便攜版，可以解壓到你想安裝的目錄。

• 注意
  運行 atom.exe 時軟件會自動在 C 盤用戶目錄產(chǎn)生 .atom 文件夾。下載的插件便放在這個文件夾里，具體為 C:\Users\Users.atom\packages。卸載 Atom 不會刪掉該文件夾，不會影響配置和插件。

  當我們第一次啟動 Atom 時，可以看到如下所示的屏幕：

?

連享會計量方法專題……

?

3. Atom + Stata

本文主要參考 「Atom + Stata」 和 「 stata_kernel 」，以 Windows 操作系統(tǒng)為例，介紹如何將 Atom 和 Stata 結(jié)合起來，利用 Atom 的編輯器功能來寫 dofile，提高輸入效率和語法高亮功能。

我們有兩種方法將 Atom 和 Stata 結(jié)合起來。 第一種方法是安裝插件 language-stata 和 stata-exec。該方法的效果和 Stata + Sublime 類似。

相較第一種方法，第二種方法更簡單，也更好用。具體操作是安裝插件 hydrogen 和 language-stata，此外還得安裝Stata Jupyter kernel，才能使運行結(jié)果直接呈現(xiàn)在代碼下方。該方法的效果和 Stata + Jupyter Notebook 類似。

---

3.1 第一種方法：Language-Stata + Stata-exec

language-stata + stata-exec

第一步：安裝 language-stata

• 方法一：點擊 File > Preferences/Settings > Install > Search packages, 搜索到 language-stata 后點擊 Install。

• 方法二：打開 cmd 命令行，輸入并執(zhí)行 apm install language-stata。

• 注意：如何打開 cmd，可參考 https://jingyan.baidu.com/article/f96699bbf01097894e3c1bc7.html。

第二步：安裝 stata-exec

點擊 File → Preferences/Settings → Install → Search packages, 搜索到 stata-exec 后點擊 Install；或者打開 cmd 命令行，輸入并執(zhí)行 apm install stata-exec。

下載 Node.js。安裝時，只需選擇安裝路徑，其他不用設(shè)置。

以管理員身份打開 cmd 或者 PowerShell 命令行。注意是要以管理員身份打開。 在命令行中輸入并執(zhí)行以下內(nèi)容：

npm install --global --production windows-build-tools

界面如下圖：

• 該過程可能會持續(xù) 5-10 分鐘，安裝 Python 及其他工具，用于下一步操作。
• 如何打開 cmd, 可參考 https://jingyan.baidu.com/article/f96699bbf01097894e3c1bc7.html；
• 如何打開 PowerShell，可參考 https://jingyan.baidu.com/article/b907e62769217346e7891c8c.html

打開 cmd 命令行，輸入并執(zhí)行以下內(nèi)容：

cd %USERPROFILE%\.atom\packages\stata-exec npm install winax --python=%USERPROFILE%\.windows-build-tools\python27\python.exe atom -v

接著我們繼續(xù)輸入并執(zhí)行：

npm rebuild winax --runtime=electron --target=ELECTRON_VERSION --disturl=https://atom.io/download/atom-shell --build-from-source

**注意：**將上述內(nèi)容中的 ELECTRON_VERSION，替換成 atom -v 輸出結(jié)果中的 Electron。比如，我在命令行中輸入 atom -v ，結(jié)果如下圖：

那我們就將 ELECTRON_VERSION 替換成 3.1.10。

Link the Stata Automation library.

在 Stata 的安裝目錄中，右鍵點擊 stata 運行程序（例如 StataMP-64 或 StataSE.exe，具體選擇取決于你的安裝版本），選擇“創(chuàng)建快捷方式”。

右鍵點擊創(chuàng)建的快捷方式 > 屬性 > 目標，將路徑用英文引號括起來，然后在后面加上/Register，如將 E:\STATA\Stata14\StataMP-64.exe 改成 "E:\STATA\Stata14\StataMP-64.exe" /Register。改完后點擊確定，再打開時目標路徑上的引號消失，表示成功。
注意：在 Register 前面是一道斜杠，而且斜杠之前還有一個空格。

右鍵點擊快捷方式，“以管理員身份運行”一次即可。

具體操作見下圖：

重新啟動 Atom 即可使用。

然后我們就可以 File > New File > Save As > 文件名.do 新建 do 文件或者 File > Open File 打開 do 文件，編寫命令。如要運行選中命令，則可使用 ctrl + enter（注意不是 ctrl + D）。

如何使用或自定義快捷鍵，請參考 stata-exec：Usage。
?

連享會計量方法專題……

---

3.2 第二種方法：Hydrogen + Language-stata + Stata_kernel

Hydrogen + language-stata + stata_kernel

安裝 Python。推薦安裝 Anaconda Python。注意 Anaconda 的安裝文件比較大，若平時并不需要使用 Python，則可以安裝 Miniconda。

若糾結(jié)安裝 Python 2.x 還是 3.x，推薦安裝 Python 3.x。

Link the Stata Automation library

在 Stata 的安裝目錄中，右鍵點擊 stata 運行程序（例如 StataMP-64 或 StataSE.exe，具體選擇取決于你的安裝版本），選擇“創(chuàng)建快捷方式”。

右鍵點擊創(chuàng)建的快捷方式 > 屬性 > 目標，將路徑用英文引號括起來，然后在后面加上/Register，如將 E:\STATA\Stata14\StataMP-64.exe 改成 "E:\STATA\Stata14\StataMP-64.exe" /Register。改完后點擊確定，再打開時目標路徑上的引號消失，表示成功。
注意：在 Register 前面是一道斜杠，而且斜杠之前還有一個空格。

右鍵點擊快捷方式，“以管理員身份運行”一次即可。
示意圖見 3.1 第一種方法。

安裝 stata_kernel。打開 cmd 命令行，輸入并執(zhí)行以下內(nèi)容：

pip install stata_kernel python -m stata_kernel.install

若你的系統(tǒng)默認使用 Python2，則在命令行中輸入并執(zhí)行以下內(nèi)容：

pip3 install stata_kernelpython3 -m stata_kernel.install

配置語法高亮功能。打開 cmd 命令行，輸入并執(zhí)行以下內(nèi)容：

conda install -c conda-forge nodejs -yjupyter labextension install jupyterlab-stata-highlight

若你未安裝 Anaconda Python，則 conda 命令無效。這時需要安裝 Node.js。安裝時，只需選擇安裝路徑，其他不用設(shè)置。安裝完成后，在命令行中運行 jupyter labextension install jupyterlab-stata-highlight。

安裝 hydrogen 插件。點擊 File > Preferences/Settings > Install > Search packages, 搜索到 hydrogen 后點擊 Install；或者打開 cmd 命令行，輸入 apm install hydrogen。

安裝 language-stata 插件。點擊 File > Preferences/Settings > Install > Search packages, 搜索到 language-stata 后點擊 Install；或者打開 cmd 命令行，輸入并執(zhí)行 apm install language-stata。

重新啟動 Atom 即可使用。

然后我們就可以 File > New File > Save As > 文件名.do 新建 do 文件或者 File > Open File 打開 do 文件，編寫命令。如要運行選中命令，則可使用 ctrl + enter（注意不是 ctrl + D）。

在運行 Stata 命令時，請注意頁面右下角，應(yīng)顯示 Stata。若沒有則按下快捷鍵 ctrl+shif+L，將文本類型選擇為 Stata。正在運行 Stata 命令時，頁面左下角會出現(xiàn) Stata | busy；命令運行完成后，左下角會變成 Stata | idle。若左下角一直出現(xiàn) Stata | busy，可以鼠標左鍵點擊此處，選擇 Restart Stata Kernel。

具體使用方法請參考 Example。

?

4. Atom 小技巧和 FAQs

最后，總結(jié)下使用 Atom 的小技巧以及配置過程中可能遇到的問題。

4.1 Atom 使用小技巧

Tip1： 顯示左側(cè)側(cè)邊欄

使用插件 Tree View (Packages → Tree View → Toggle 或者快捷鍵 ctrl + \)，即可打開左側(cè)側(cè)邊欄，顯示文件夾及文件。效果圖如下：

Tip2：Atom 的漢化

使用插件 Simplified Chinese Menu 可支持漢化。具體做法如下：

依次點擊 File → Preferences/Settings → Install → Search packages, 搜索到 Simplified Chinese Menu 后點擊 「Install」；或者打開 cmd 命令行，輸入并執(zhí)行 apm install Simplified Chinese Menu。

4.2 Atom 設(shè)定常見問題 (FAQs)

• FAQ 1: 打開 Atom 時，右上角提示錯誤：Cannot load the system dictionary for zh-CN.

  • A: 點擊 File → Preferences/Settings → Packages 搜索 spell-check 后，點擊 Settings，將 Use Locales 前的勾去掉，并在下面填入 en-US。具體請參考 https://www.jianshu.com/p/dcb758424e07。

• FAQ 2: 如何卸載或關(guān)閉插件？

  • A: 點擊 File > Preferences/Settings > Packages，選中想要卸載（關(guān)閉）的插件，點擊 Uninsall(Disable)。

• FAQ 3: 在 Atom 中利用 File > Preferences/Settings > Install 或 apm 下載插件很慢怎么辦？

  • A: 此時可以手動安裝插件。此處以安裝 hydrogen 插件為例進行說明。

• 進入 Atom ，點擊左上角的 「Packages」 按鈕，在搜索框中輸入插件的名稱，再點擊 「Repo」，跳轉(zhuǎn)到 gitHub 頁面。也可直接在 GitHub 中搜索插件。

• 在跳轉(zhuǎn)到的 gitHub 頁面中下載插件。 hydrogen 的 gitHub 頁面如下:
  

  點擊右側(cè)的 Clone or download 下載壓縮包或者點擊上方的 releases，選擇相應(yīng)的版本進行下載壓縮包。

• 將壓縮包解壓放到 C:\Users\lily\.atom\packages 路徑下（注意：lily 為我的用戶名，在操作中改成你的用戶名即可），再將文件名重命名為插件名稱，不要包含 - 后的后綴。

• 打開 cmd 命令行，輸入并執(zhí)行以下命令，進入 C:\Users\Users\.atom\packages 這個路徑：

  cd %USERPROFILE%\.atom\packages\hydrogen

• 在 cmd 命令行，輸入并執(zhí)行以下命令，便完成了插件的安裝：

  apm install

  或者

  npm install

  具體請參考 https://www.jianshu.com/p/d0e86b9607c8。

• FAQ 4: 為何在 cmd 命令行中，輸入 apm ... 后會報錯 「不是內(nèi)部或外部命令，也不是可運行的程序或批處理文件。」？

  • A: 將 apm 的路徑添加到環(huán)境變量 path 中。

• 找到 apm 的路徑。我將 Atom 安裝在 E 盤，路徑為 E:\Atom\Atom x64\resources\app\apm\bin；若將 Atom 的安裝路徑在 C 盤，路徑類似如下：C:\Users\XXXX\AppData\Local\atom\app- 1.40.0\resources\app\apm\bin。

• 將此路徑添加環(huán)境變量。在“我的電腦”上右擊鼠標，在彈出菜單中選擇“屬性”。在“系統(tǒng)”界面選擇“高級系統(tǒng)設(shè)置”，點開“環(huán)境變量”。最后在“用戶變量”中添加環(huán)境變量 path。

• FAQ 5: 在 cmd 命令行中，輸入 atom -v，為何報錯 「不是內(nèi)部或外部命令，也不是可運行的程序或批處理文件」？

  • A: 安裝插件 atom-shell-commands 即可。依次點擊 File > Preferences/Settings > Install > Search packages, 搜索到 atom-shell-commands 后點擊 Install；或者打開 cmd 命令行，輸入并執(zhí)行 apm install atom-shell-commands。

---

?

5. 結(jié)語

合理借助外部編輯器編寫并運行 dofile，我們可以大幅度提高效率和。Atom + Stata 編輯模式是很不錯的選擇。
?

相關(guān)鏈接

• Atom + Stata
• language-stata
• stata-exec
• stata_kernel
• Atom 更為先進的文本代碼編輯器
• Stata+Sublime：美觀高效的dofile編輯器
• 珠聯(lián)璧合：Jupyter Notebook 與 Stata 之融合
• How to install anaconda
• How to use anaconda

?

?

---

關(guān)于我們

• Stata連享會 由中山大學連玉君老師團隊創(chuàng)辦，定期分享實證分析經(jīng)驗。直播間 有很多視頻課程，可以隨時觀看。
• 你的頸椎還好嗎？ 您將 ::連享會-主頁:: 和 ::連享會-知乎專欄:: 收藏起來，以便隨時在電腦上查看往期推文。
• 公眾號推文分類： 計量專題 | 分類推文 | 資源工具。推文分成 內(nèi)生性 | 空間計量 | 時序面板 | 結(jié)果輸出 | 交乘調(diào)節(jié) 五類，主流方法介紹一目了然：DID, RDD, IV, GMM, FE, Probit 等。
• 公眾號關(guān)鍵詞搜索/回復 功能已經(jīng)上線。大家可以在公眾號左下角點擊鍵盤圖標，輸入簡要關(guān)鍵詞，以便快速呈現(xiàn)歷史推文，獲取工具軟件和數(shù)據(jù)下載。常見關(guān)鍵詞：
  • 課程, 直播, 視頻, 客服, 模型設(shè)定, 研究設(shè)計,
  • stata, plus，Profile, 手冊, SJ, 外部命令, profile, mata, 繪圖, 編程, 數(shù)據(jù), 可視化
  • DID，RDD, PSM，IV，DID, DDD, 合成控制法，內(nèi)生性, 事件研究
  • 交乘, 平方項, 缺失值, 離群值, 縮尾, R2, 亂碼, 結(jié)果
  • Probit, Logit, tobit, MLE, GMM, DEA, Bootstrap, bs, MC, TFP
  • 面板, 直擊面板數(shù)據(jù), 動態(tài)面板, VAR, 生存分析, 分位數(shù)
  • 空間, 空間計量, 連老師, 直播, 爬蟲, 文本, 正則, python
  • Markdown, Markdown幻燈片, marp, 工具, 軟件, Sai2, gInk, Annotator, 手寫批注
  • 盈余管理, 特斯拉, 甲殼蟲, 論文重現(xiàn)
  • 易懂教程, 碼云, 教程, 知乎

---

總結(jié)

以上是生活随笔為你收集整理的Stata+Atom: 强强联手打造编辑利器的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。