Stata+Atom: 强强联手打造编辑利器

是 否 +2 论坛币

k人 参与回答

经管之家送您一份

应届毕业生专属福利!

求职就业群

赵安豆老师微信：zhaoandou666

经管之家联合CDA

送您一个全额奖学金名额~ !

立即领取

感谢您参与论坛问题回答

经管之家送您两个论坛币！

+2 论坛币

作者：万莉 (北京航空航天大学)
 
Stata 连享会：(知乎 | 简书 | 码云 | CSDN)

 

2019金秋十月-空间计量专题班，杨海生主讲，成都

 

Stata连享会   计量专题 || 精品课程 || 简书推文 || 公众号合集

引言

我们可以借助外部编辑器编写并运行 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 和 Stata Jupyter kernel），是不是很炫酷！

[图片上传失败…(image-849ee2-1566921583209)]

 

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，此外还得安装Stata Jupyter kernel，才能使运行结果直接呈现在代码下方。该方法的效果和 Stata + Jupyter Notebook 类似。

---

3.1 第一种方法：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

1. 点击 File → Preferences/Settings → Install → Search packages, 搜索到 stata-exec 后点击 Install；或者打开 cmd 命令行，输入并执行 apm install stata-exec。

2. 下载 Node.js。安装时，只需选择安装路径，其他不用设置。

3. 以管理员身份打开 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

4. 打开 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。

5. Link the Stata Automation library.

   1. 在 Stata 的安装目录中，右键点击 stata 运行程序（例如 StataMP-64 或 StataSE.exe，具体选择取决于你的安装版本），选择“创建快捷方式”。
   2. 右键点击创建的快捷方式 > 属性 > 目标，将路径用英文引号括起来，然后在后面加上/Register，如将 E:\STATA\Stata14\StataMP-64.exe 改成 "E:\STATA\Stata14\StataMP-64.exe" /Register。改完后点击确定，再打开时目标路径上的引号消失，表示成功。
      注意：在 Register 前面是一道斜杠，而且斜杠之前还有一个空格。

   3. 右键点击快捷方式，“以管理员身份运行”一次即可。

      具体操作见下图：[图片上传失败…(image-bde225-1567243043408)]

6. 重新启动 Atom 即可使用。

   然后我们就可以 File > New File > Save As > 文件名.do 新建 do 文件或者 File > Open File 打开 do 文件，编写命令。如要运行选中命令，则可使用 ctrl + enter（注意不是 ctrl + D）。

   如何使用或自定义快捷键，请参考 stata-exec：Usage。
    

连享会计量方法专题……

---

3.2 第二种方法：Hydrogen + stata_kernel

1. 安装 Python。推荐安装 Anaconda Python。注意 Anaconda 的安装文件比较大，若平时并不需要使用 Python，则可以安装 Miniconda。

   若纠结安装 Python 2.x 还是 3.x，推荐安装 Python 3.x。

2. Link the Stata Automation library

   1. 在 Stata 的安装目录中，右键点击 stata 运行程序（例如 StataMP-64 或 StataSE.exe，具体选择取决于你的安装版本），选择“创建快捷方式”。
   2. 右键点击创建的快捷方式 > 属性 > 目标，将路径用英文引号括起来，然后在后面加上/Register，如将 E:\STATA\Stata14\StataMP-64.exe 改成 "E:\STATA\Stata14\StataMP-64.exe" /Register。改完后点击确定，再打开时目标路径上的引号消失，表示成功。
      注意：在 Register 前面是一道斜杠，而且斜杠之前还有一个空格。

   3. 右键点击快捷方式，“以管理员身份运行”一次即可。
      示意图见 3.1 第一种方法。

3. 安装 stata_kernel。打开 cmd 命令行，输入并执行以下内容：

   pip install stata_kernel
   python -m stata_kernel.install
   

   若你的系统默认使用 Python2，则在命令行中输入并执行以下内容：

    pip3 install stata_kernel
    python3 -m stata_kernel.install
   

4. 配置语法高亮功能。打开 cmd 命令行，输入并执行以下内容：

    conda install -c conda-forge nodejs -y
    jupyter labextension install jupyterlab-stata-highlight
   

   若你未安装 Anaconda Python，则 conda 命令无效。这时需要安装 Node.js。安装时，只需选择安装路径，其他不用设置。安装完成后，在命令行中运行 jupyter labextension install jupyterlab-stata-highlight。

5. 安装 hydrogen 插件。点击 File > Preferences/Settings > Install > Search packages, 搜索到 hydrogen 后点击 Install；或者打开 cmd 命令行，输入 apm install hydrogen。

6. 重新启动 Atom 即可使用。

   然后我们就可以 File > New File > Save As > 文件名.do 新建 do 文件或者 File > Open File 打开 do 文件，编写命令。如要运行选中命令，则可使用 ctrl + enter（注意不是 ctrl + D）。

   具体使用方法请参考 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 插件为例进行说明。

  1. 进入 Atom ，点击左上角的 「Packages」 按钮，在搜索框中输入插件的名称，再点击 「Repo」，跳转到 gitHub 页面。也可直接在 GitHub 中搜索插件。

  2. 在跳转到的 gitHub 页面中下载插件。 hydrogen 的 gitHub 页面如下:
     

     点击右侧的 Clone or download 下载压缩包或者点击上方的 releases，选择相应的版本进行下载压缩包。

  3. 将压缩包解压放到 C:\Users\lily\.atom\packages 路径下（注意：lily 为我的用户名，在操作中改成你的用户名即可），再将文件名重命名为插件名称，不要包含 - 后的后缀。

  4. 打开 cmd 命令行，输入并执行以下命令，进入 C:\Users\Users\.atom\packages 这个路径：

     cd %USERPROFILE%\.atom\packages\hydrogen
     

  5. 在 cmd 命令行，输入并执行以下命令，便完成了插件的安装：

     apm install
     

     或者

     npm install
     

     具体请参考 https://www.jianshu.com/p/d0e86b9607c8。

• FAQ 4: 为何在 cmd 命令行中，输入 apm ... 后会报错 「不是内部或外部命令，也不是可运行的程序或批处理文件。」？

  • A: 将 apm 的路径添加到环境变量 path 中。

  1. 找到 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。

  2. 将此路径添加环境变量。在“我的电脑”上右击鼠标，在弹出菜单中选择“属性”。在“系统”界面选择“高级系统设置”，点开“环境变量”。最后在“用户变量”中添加环境变量 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 连享会(公众号：StataChina)】由中山大学连玉君老师团队创办，旨在定期与大家分享 Stata 应用的各种经验和技巧。
• 公众号推文同步发布于 CSDN-Stata连享会 、简书-Stata连享会 和 知乎-连玉君Stata专栏。可以在上述网站中搜索关键词Stata或Stata连享会后关注我们。
• 点击推文底部【阅读原文】可以查看推文中的链接并下载相关资料。
• Stata连享会 计量专题 || 精彩推文

联系我们

• 欢迎赐稿： 欢迎将您的文章或笔记投稿至 StataChina@163.com，我们会保留您的署名；录用稿件达五篇以上，即可免费获得 Stata 现场培训 (初级或高级选其一) 资格。您也可以从 连享会选题平台 → [002_备选主题] 中选择感兴趣的题目来撰写推文，网址为：https://gitee.com/Stata002/StataSX2018/wikis/Home。
• 招募英才： 欢迎加入我们的团队，一起学习 Stata。合作编辑或撰写稿件五篇以上，即可免费获得 Stata 现场培训 (初级或高级选其一) 资格。
• 联系邮件： StataChina@163.com

往期精彩推文

Stata连享会   计量专题 || 精品课程 || 简书推文 || 公众号合集

---

扫码加我 拉你入群

请注明：姓名-公司-职位

以便审核进群资格，未注明则拒绝

分享0 收藏2 回帖

请问老师，在第二种方法中“右键点击创建的快捷方式 > 属性 > 目标，将路径用英文引号括起来，然后在后面加上/Register，如将 E:\STATA\Stata14\StataMP-64.exe 改成 "E:\STATA\Stata14\StataMP-64.exe" /Register。改完后点击确定，再打开时目标路径上的引号消失，表示成功。”改完后引号没有消失是怎么会是呢？

qq1032450349 发表于 2019-9-15 11:15
请问老师，在第二种方法中“右键点击创建的快捷方式 > 属性 > 目标，将路径用英文引号括起来，然后在后面加 ...

有几点需要注意，如下：
   1. 在修改路径时，需要用**英文**引号，不能用**中文**引号。
   2. 在修改路径时，Register 前面是一道斜杠，而且斜杠之前还有一个空格。
   
  还可参考文章[「如何用Sublime Text 3改善Stata命令编写环境？」](https://www.jianshu.com/p/1255eee18a08) 中 **4、安装Stata Automation object 并注册 Stata Automation type library** 部分；[「珠联璧合：Jupyter Notebook 与 Stata 之融合」](https://www.jianshu.com/p/2f52064865c4)中 **2. 将 stata 添加到命令行注册** 部分。

有几点需要注意，如下：

1. 在修改路径时，需要用英文引号，不能用中文引号。
2. 在修改路径时，Register 前面是一道斜杠，而且斜杠之前还有一个空格。

还可参考文章「如何用Sublime Text 3改善Stata命令编写环境？」 中 4、安装Stata Automation ob ject 并注册 Stata Automation type library 部分；「珠联璧合：Jupyter Notebook 与 Stata 之融合」中 2. 将 stata 添加到命令行注册 部分。