EmacsTalk

project.el 使用说明

  tags: tips project

文章目录

在之前的文章中就多次提到过 28 版本的 project.el 是如何好用，但一直没去详细介绍，这篇文章就来填上这个坑。一句话总结，project.el 完全可以替换 projectile。

下载

直接编译 28 版本或者在 elpa 下载最新版。project 相关命令绑定在 C-x p ，笔者使用的相关配置在 project-config.el，共读者参考。

根目录

在日常编程中，Emacs 的很多包都依赖一个功能：查找当前项目的根目录，比如 lsp-mode、citre 等。在 project.el 中，默认只支持 VC 中的 Git，即 project-try-vc，但可以自定义找根目录的方式，配置如下：

(defun my/project-try-local (dir)
  "Determine if DIR is a non-Git project."
  (catch 'ret
    (let ((pr-flags '((".project")
                      ("go.mod" "Cargo.toml" "project.clj" "pom.xml" "package.json") ;; higher priority
                      ("Makefile" "README.org" "README.md"))))
      (dolist (current-level pr-flags)
        (dolist (f current-level)
          (when-let ((root (locate-dominating-file dir f)))
            (throw 'ret (cons 'local root))))))))

(setq project-find-functions '(my/project-try-local project-try-vc))

project-find-functions 是 project.el 中用于查找根目录的函数列表，默认只有 project-try-vc ，这里额外定义了一个 my/project-try-local 。

该函数使用一些文件作为根目录标识，只要某个文件夹内有 pr-flags 定义的文件，都可以看作项目根目录，并且具有如下优先级顺序：

  1. .project ，与 .projectile 类似
  2. 常用编程语言的依赖描述文件
  3. Makefile/README 文件

比如有如下文件目录结构：

project-demo/
├── .project
├── bar
│   └── pom.xml
└── foo
    └── package.json

由于 project-demo 内有 .project 文件，所以 bar/foo 不再是根目录，这个特性主要用在 monorepo 中。

该函数返回一个 cons，car 为项目类型，这里定义为 local，cdr 为根目录。

查找文件

查找文件是非常高频的操作，可以使用 Rust 编写的 fd 来代替 find，速度更快。配置如下：

(defun my/project-files-in-directory (dir)
  "Use `fd' to list files in DIR."
  (let* ((default-directory dir)
         (localdir (file-local-name (expand-file-name dir)))
         (command (format "fd -H -t f -0 . %s" localdir)))
    (project--remote-file-names
     (sort (split-string (shell-command-to-string command) "\0" t)
           #'string<))))

(cl-defmethod project-files ((project (head local)) &optional dirs)
  "Override `project-files' to use `fd' in local projects."
  (mapcan #'my/project-files-in-directory
          (or dirs (list (project-root project)))))

通过重载 project-files ， M-x project-find-file 时就会用 fd 来搜索文件了。

常用命令

project.el 提供了很多命令来方便在项目中进行操作，这里列举几个常用的：

  • project-remember-projects-under，增加项目
  • project-forget-project，删除项目
  • project-switch-project，切换项目
  • project-compile，执行项目的 compile 命令
  • project-search，在项目中搜索指定关键字
  • project-query-replace-regexp，在项目中执行正则替换
  • project-shell-command，执行 shell 命令
  • project-eshell，在根目录打开 eshell
  • project-dired，在根目录打开 dired
  • project-find-dir，在项目指定目录打开 dired
  • project-switch-to-buffer，切换到项目中已经打开的 buffer

扩展命令

(defun my/project-info ()
  (interactive)
  (message "%s" (project-current t)))

(defun my/add-dot-project ()
  (interactive)
  (let* ((root-dir (read-directory-name "Root: "))
         (f (expand-file-name ".project" root-dir)))
    (message "Create %s..." f)
    (make-empty-file f)))

(defun my/project-discover ()
  "Add dir under search-path to project."
  (interactive)
  (dolist (search-path '("~/code/" "~/git/"))
    (dolist (file (file-name-all-completions  "" search-path))
      (when (not (member file '("./" "../")))
        (let ((full-name (expand-file-name file search-path)))
          (when (file-directory-p full-name)
            (when-let ((pr (project-current nil full-name)))
              (project-remember-project pr)
              (message "add project %s..." pr))))))))

上面函数的功能通过名字即可看出，这里不再赘述。

收听方式

反馈