Ropemacs 使用教程

有很多网站都有相关说明安装Ropemacs，但到目前为止我找不到任何有关如何操作的说明use安装完成后即可。我已经安装了它，或者至少看起来是这样，Emacs 在其顶部菜单栏中有“Rope”菜单。怎么办？到目前为止，我只能使用“显示文档”（默认情况下为 C-c d）。尝试使用代码辅助（我想这是自动完成的？）只会导致 Emacs 询问迷你缓冲区中的“Rope 项目根文件夹”（那是什么？），然后什么也不显示。

那么，一旦安装了 rodemacs，要在一些简单的 python 脚本上看到它的运行情况需要采取哪些步骤呢？类似于“如果你的 emacs 中有这个脚本并将闪烁的方块here并按this，它确实that”将是一个答案。

（我一直在想是否应该问这个问题有一段时间了，因为似乎没有其他人有同样的问题）

好吧，您首先需要选择项目根文件夹。很简单，这是项目顶层的文件夹，或者如果您正在处理单个文件，则为当前文件夹。选择根文件夹后，其他选项将起作用，例如代码辅助、显示文档、跳转到其他符号等。

为了充分利用 Ropemacs，我建议自动完成.el http://cx4a.org/software/auto-complete/，将其放入 ~/.emacs.d，然后将其添加到您的 .emacs

(add-to-list 'load-path "~/.emacs.d/")
(add-to-list 'load-path "~/.emacs.d/auto-complete-1.2")
(autoload 'python-mode "python-mode" "Python Mode." t)
(add-to-list 'auto-mode-alist '("\\.py\\'" . python-mode))
(add-to-list 'interpreter-mode-alist '("python" . python-mode))
(require 'python-mode)
(autoload 'pymacs-apply "pymacs")
(autoload 'pymacs-call "pymacs")
(autoload 'pymacs-eval "pymacs" nil t)
(autoload 'pymacs-exec "pymacs" nil t)
(autoload 'pymacs-load "pymacs" nil t)
(pymacs-load "ropemacs" "rope-")
(setq ropemacs-enable-autoimport t)

(require 'auto-complete)
(global-auto-complete-mode t)

这假设您在 ~/.emacs.d/auto-complete-1.2 中安装了自动完成功能。执行此操作后，您将在输入单词或符号的几个字符后自动完成自动完成。

您可以修改 ROOT/.ropeproject/config.py 文件以向绳索查找路径添加更多目录，以提供更好的自动完成功能。

编辑：对我来说最重要的两个功能是查找文档和直接跳转到函数定义。这取决于如上所述为您的项目正确设置绳索查找路径。

文档：将光标放在符号（函数名称、类名称等）上，然后执行以下操作：

C-c d

这将向您显示相关符号的文档字符串。

跳转到定义：将光标放在符号（函数名称、类名称等）上，然后执行以下操作：

C-c g

这将立即打开符号所在的文件并跳转到定​​义的开头。当文档稀疏并且您想查看实际代码时，这非常有用。另外，它非常适合在您自己的代码中导航。

查找出现的情况:

C-c f

在整个项目中智能搜索光标处的符号。

代码辅助:

M-/

只需键入函数、类等的第一个字符，就会显示可能的补全列表。请注意，由于 python 的性质，它并不总是完整的列表。

重构： Rope->Refactor 下有相当多的选项。这些是为了更好地组织您的代码。如何使用它们应该是不言自明的；一般来说，选择要重构的代码区域，然后选择命令。

Edit： 为了回应下面的评论，这里具体介绍了如何将其他路径添加到 python 路径中，以便自动完成功能也会查找这些符号。

prefs.add('python_path', '~/path/to/virtualenv/lib/python2.6/site-packages')

这进入.ropeproject/config.py