Stata+Atom: 强强联手打造编辑利器
作者：萬莉 (北京航空航天大學)
?
連享會 - 與君分享 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： 顯示左側側邊欄
- Tip2：Atom 的漢化
- 4.2 Atom 設定常見問題 (FAQs)
- 5. 結語
- 相關鏈接
- 關于我們
引言
我們可以借助外部編輯器編寫并運行 dofile，從而提高輸入效率和語法高亮功能。那我們可以選擇哪些外部編輯器呢？
參考「Stata+Sublime：美觀高效的dofile編輯器」和「珠聯璧合：Jupyter Notebook 與 Stata 之融合」，我們可以選用 Sublime 和 Jupyter Notebook。相較 Sublime，Jupyter Notebook 能使運行的結果直接顯示在代碼下方，更方便查看。
本文將介紹 Atom 這一編輯神器——被開發團隊稱為“一個為 21 世紀所創造的可配置編輯器 (A hackable text editor for the 21st Century)”。通過下載相應插件 (Package)，我們既能實現 Stata + Sublime 的效果，也能實現 Stata + Jupyter Notebook 的效果。
我們先看看效果圖 （安裝插件 Hydrogen、language-stata 和 Stata Jupyter kernel），是不是很炫酷！
?
1. 什么是 Atom ？
Atom 是一個免費的跨平臺編輯器，已在 GitHub 上開放了全部源代碼。它擁有非常精致細膩的界面和豐富的可配置項。
它提供了與 SublimeText 類似的 Package Control (包管理)功能。我們可以非常方便地安裝、管理各種插件，并將 Atom 打造成真正適合自己的開發工具。
最大的亮點是，該編輯器由 GitHub（目前全球范圍內影響力最大的代碼倉庫/開源社區） 打造，有著很大的發展潛力。開源社區非常非常活躍，能及時解決各種問題。
?
2. Atom 的安裝
-
方法一
在官網上 Atom 直接點擊 Download，便可下載最新版本。注意：缺點是雙擊 exe 文件便直接安裝在 C 盤，無法自定義安裝路徑。 -
方法二
在官網上 Atom 點擊 Other platforms 或者打開 https://github.com/atom/atom/releases，根據自己的系統，選擇對應的壓縮包。該壓縮包為便攜版，可以解壓到你想安裝的目錄。 -
注意
運行 atom.exe 時軟件會自動在 C 盤用戶目錄產生 .atom 文件夾。下載的插件便放在這個文件夾里，具體為 C:\Users\Users.atom\packages。卸載 Atom 不會刪掉該文件夾，不會影響配置和插件。當我們第一次啟動 Atom 時，可以看到如下所示的屏幕：
?
連享會計量方法專題……
?
3. Atom + Stata
本文主要參考 「Atom + Stata」 和 「 stata_kernel 」，以 Windows 操作系統為例，介紹如何將 Atom 和 Stata 結合起來，利用 Atom 的編輯器功能來寫 dofile，提高輸入效率和語法高亮功能。
我們有兩種方法將 Atom 和 Stata 結合起來。 第一種方法是安裝插件 language-stata 和 stata-exec。該方法的效果和 Stata + Sublime 類似。
相較第一種方法，第二種方法更簡單，也更好用。具體操作是安裝插件 hydrogen 和 language-stata，此外還得安裝Stata Jupyter kernel，才能使運行結果直接呈現在代碼下方。該方法的效果和 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 命令行，輸入并執行 apm install language-stata。
-
注意：如何打開 cmd，可參考 https://jingyan.baidu.com/article/f96699bbf01097894e3c1bc7.html。
第二步：安裝 stata-exec
點擊 File → Preferences/Settings → Install → Search packages, 搜索到 stata-exec 后點擊 Install；或者打開 cmd 命令行，輸入并執行 apm install stata-exec。
下載 Node.js。安裝時，只需選擇安裝路徑，其他不用設置。
以管理員身份打開 cmd 或者 PowerShell 命令行。注意是要以管理員身份打開。 在命令行中輸入并執行以下內容：
npm install --global --production windows-build-tools界面如下圖：
- 該過程可能會持續 5-10 分鐘，安裝 Python 及其他工具，用于下一步操作。
- 如何打開 cmd, 可參考 https://jingyan.baidu.com/article/f96699bbf01097894e3c1bc7.html；
- 如何打開 PowerShell，可參考 https://jingyan.baidu.com/article/b907e62769217346e7891c8c.html
打開 cmd 命令行，輸入并執行以下內容：
cd %USERPROFILE%\.atom\packages\stata-exec npm install winax --python=%USERPROFILE%\.windows-build-tools\python27\python.exe atom -v接著我們繼續輸入并執行：
npm rebuild winax --runtime=electron --target=ELECTRON_VERSION --disturl=https://atom.io/download/atom-shell --build-from-source**注意：**將上述內容中的 ELECTRON_VERSION，替換成 atom -v 輸出結果中的 Electron。比如，我在命令行中輸入 atom -v ，結果如下圖：
那我們就將 ELECTRON_VERSION 替換成 3.1.10。
Link the Stata Automation library.
注意：在 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。
若糾結安裝 Python 2.x 還是 3.x，推薦安裝 Python 3.x。
Link the Stata Automation library
注意：在 Register 前面是一道斜杠，而且斜杠之前還有一個空格。
示意圖見 3.1 第一種方法。
安裝 stata_kernel。打開 cmd 命令行，輸入并執行以下內容：
pip install stata_kernel python -m stata_kernel.install若你的系統默認使用 Python2，則在命令行中輸入并執行以下內容：
pip3 install stata_kernelpython3 -m stata_kernel.install配置語法高亮功能。打開 cmd 命令行，輸入并執行以下內容：
conda install -c conda-forge nodejs -yjupyter labextension install jupyterlab-stata-highlight若你未安裝 Anaconda Python，則 conda 命令無效。這時需要安裝 Node.js。安裝時，只需選擇安裝路徑，其他不用設置。安裝完成后，在命令行中運行 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 命令行，輸入并執行 apm install language-stata。
重新啟動 Atom 即可使用。
然后我們就可以 File > New File > Save As > 文件名.do 新建 do 文件或者 File > Open File 打開 do 文件，編寫命令。如要運行選中命令，則可使用 ctrl + enter（注意不是 ctrl + D）。
在運行 Stata 命令時，請注意頁面右下角，應顯示 Stata。若沒有則按下快捷鍵 ctrl+shif+L，將文本類型選擇為 Stata。正在運行 Stata 命令時，頁面左下角會出現 Stata | busy；命令運行完成后，左下角會變成 Stata | idle。若左下角一直出現 Stata | busy，可以鼠標左鍵點擊此處，選擇 Restart Stata Kernel。
具體使用方法請參考 Example。
?
4. Atom 小技巧和 FAQs
最后，總結下使用 Atom 的小技巧以及配置過程中可能遇到的問題。
4.1 Atom 使用小技巧
Tip1： 顯示左側側邊欄
使用插件 Tree View (Packages → Tree View → Toggle 或者快捷鍵 ctrl + \)，即可打開左側側邊欄，顯示文件夾及文件。效果圖如下：
Tip2：Atom 的漢化
使用插件 Simplified Chinese Menu 可支持漢化。具體做法如下：
依次點擊 File → Preferences/Settings → Install → Search packages, 搜索到 Simplified Chinese Menu 后點擊 「Install」；或者打開 cmd 命令行，輸入并執行 apm install Simplified Chinese Menu。
4.2 Atom 設定常見問題 (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: 如何卸載或關閉插件？
- A: 點擊 File > Preferences/Settings > Packages，選中想要卸載（關閉）的插件，點擊 Uninsall(Disable)。
-
FAQ 3: 在 Atom 中利用 File > Preferences/Settings > Install 或 apm 下載插件很慢怎么辦？
- A: 此時可以手動安裝插件。此處以安裝 hydrogen 插件為例進行說明。
-
進入 Atom ，點擊左上角的 「Packages」 按鈕，在搜索框中輸入插件的名稱，再點擊 「Repo」，跳轉到 gitHub 頁面。也可直接在 GitHub 中搜索插件。
-
在跳轉到的 gitHub 頁面中下載插件。 hydrogen 的 gitHub 頁面如下:
點擊右側的 Clone or download 下載壓縮包或者點擊上方的 releases，選擇相應的版本進行下載壓縮包。
-
將壓縮包解壓放到 C:\Users\lily\.atom\packages 路徑下（注意：lily 為我的用戶名，在操作中改成你的用戶名即可），再將文件名重命名為插件名稱，不要包含 - 后的后綴。
-
打開 cmd 命令行，輸入并執行以下命令，進入 C:\Users\Users\.atom\packages 這個路徑：
cd %USERPROFILE%\.atom\packages\hydrogen -
在 cmd 命令行，輸入并執行以下命令，便完成了插件的安裝：
apm install或者
npm install具體請參考 https://www.jianshu.com/p/d0e86b9607c8。
-
FAQ 4: 為何在 cmd 命令行中，輸入 apm ... 后會報錯 「不是內部或外部命令，也不是可運行的程序或批處理文件。」？
- A: 將 apm 的路徑添加到環境變量 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。
-
將此路徑添加環境變量。在“我的電腦”上右擊鼠標，在彈出菜單中選擇“屬性”。在“系統”界面選擇“高級系統設置”，點開“環境變量”。最后在“用戶變量”中添加環境變量 path。
-
FAQ 5: 在 cmd 命令行中，輸入 atom -v，為何報錯 「不是內部或外部命令，也不是可運行的程序或批處理文件」？
- A: 安裝插件 atom-shell-commands 即可。依次點擊 File > Preferences/Settings > Install > Search packages, 搜索到 atom-shell-commands 后點擊 Install；或者打開 cmd 命令行，輸入并執行 apm install atom-shell-commands。
?
5. 結語
合理借助外部編輯器編寫并運行 dofile，我們可以大幅度提高效率和。Atom + Stata 編輯模式是很不錯的選擇。
?
相關鏈接
- Atom + Stata
- language-stata
- stata-exec
- stata_kernel
- Atom 更為先進的文本代碼編輯器
- Stata+Sublime：美觀高效的dofile編輯器
- 珠聯璧合：Jupyter Notebook 與 Stata 之融合
- How to install anaconda
- How to use anaconda
?
?
關于我們
- Stata連享會 由中山大學連玉君老師團隊創辦，定期分享實證分析經驗。直播間 有很多視頻課程，可以隨時觀看。
- 你的頸椎還好嗎？ 您將 ::連享會-主頁:: 和 ::連享會-知乎專欄:: 收藏起來，以便隨時在電腦上查看往期推文。
- 公眾號推文分類： 計量專題 | 分類推文 | 資源工具。推文分成 內生性 | 空間計量 | 時序面板 | 結果輸出 | 交乘調節 五類，主流方法介紹一目了然：DID, RDD, IV, GMM, FE, Probit 等。
- 公眾號關鍵詞搜索/回復 功能已經上線。大家可以在公眾號左下角點擊鍵盤圖標，輸入簡要關鍵詞，以便快速呈現歷史推文，獲取工具軟件和數據下載。常見關鍵詞：
- 課程, 直播, 視頻, 客服, 模型設定, 研究設計,
- stata, plus，Profile, 手冊, SJ, 外部命令, profile, mata, 繪圖, 編程, 數據, 可視化
- DID，RDD, PSM，IV，DID, DDD, 合成控制法，內生性, 事件研究
- 交乘, 平方項, 缺失值, 離群值, 縮尾, R2, 亂碼, 結果
- Probit, Logit, tobit, MLE, GMM, DEA, Bootstrap, bs, MC, TFP
- 面板, 直擊面板數據, 動態面板, VAR, 生存分析, 分位數
- 空間, 空間計量, 連老師, 直播, 爬蟲, 文本, 正則, python
- Markdown, Markdown幻燈片, marp, 工具, 軟件, Sai2, gInk, Annotator, 手寫批注
- 盈余管理, 特斯拉, 甲殼蟲, 論文重現
- 易懂教程, 碼云, 教程, 知乎
總結
以上是生活随笔為你收集整理的Stata+Atom: 强强联手打造编辑利器的全部內容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： ESD标准文件
- 下一篇： 怎么彻底删除users下的文件夹_什么工