很多人以为 Tramp 只能远程打开文件编辑，其实它对所有需要执行命令的操作都生效。当你通过 Tramp 访问远程主机时，以下操作都会自动在远程机器上执行：

• M-x shell / M-x eshell ：打开的 shell 运行在远程机器上，你输入的命令都在远程执行
• M-x compile ：编译命令在远程环境运行
• M-x rgrep ：find 和 grep 在远程文件系统中搜索
• dired 中操作文件：复制、重命名、删除都在远程完成

这意味着远程机器上能不能找到程序（比如 go 、 gcc 、 rg ）直接决定了这些操作能不能正常工作，而 Tramp 用什么路径去找程序，就是本文要讲的核心问题。

Tramp 最常用的连接方法是 ssh 和 sshx ，写法分别是 /ssh:host: 和 /sshx:host: 。

ssh 方法会先走一遍完整的登录流程（执行你的 .profile 、 .bashrc 之类），然后切到 /bin/sh 并设置特殊的提示符。注意，走登录流程的目的是让 Tramp 能在远程 shell 里正确执行初始化命令，并不是为了继承你 .profile 里设置的 $PATH 。初始化完成后，Tramp 用自己的 tramp-remote-path 来决定去哪些目录找程序。

所以 Tramp 对远程 shell 有几个要求：

1. **提示符格式要常规**。如果你的提示符里有多行内容、ANSI 颜色码、或者特殊字符，Tramp 可能认不出来。它用 tramp-shell-prompt-pattern 这个正则来匹配提示符，不匹配就会被当作命令输出的一部分，导致 Tramp 的命令解析乱掉。
2. **要支持反斜杠转义**。Tramp 发给远程 shell 的命令会用反斜杠转义特殊字符（通过 shell-quote-argument 函数）。只有 - 、 . 、 / 、数字和字母不会加反斜杠。如果你的 shell 不按这个规则处理转义，命令就会出错。
3. **登录过程不能停**。如果你的 .profile 里有个 read 等待用户输入，或者打印了一段很长的欢迎信息后没有马上出现提示符，Tramp 会卡住。

sshx 方法直接运行 /bin/sh ，跳过整个登录流程。对 shell 环境几乎没要求，连接也更快。但 .profile 没执行，远程机器上的环境变量（包括 $PATH ）不会被设置。

如果你的远程 shell 环境不太常规（比如用了 zsh 配了一堆花哨的提示符，或者 .profile 里有交互式的东西）， sshx 是更稳的选择。因为 sshx 直接跑 /bin/sh ，不经过你的登录流程，所以那些花哨提示符和交互式内容根本没机会干扰 Tramp。

tramp-remote-path 是一个路径列表，Tramp 在连接远程主机时会逐个检查列表里的目录是否存在于远程机器上，只保留存在的那些。

注意几个坑：

~ 和 $HOME 不能用。 Tramp 文档里有些示例暗示你可以在路径里用 ~ ，但实际上不行。Tramp 在检查目录是否存在时，会对路径加引号再发给远程 shell，加了引号之后 shell 就不会展开 ~ 和 $HOME 了。所以下面这样写是没有效果的：

;; 这样写不生效，~ 不会被展开
(add-to-list 'tramp-remote-path "~/go/bin")
(add-to-list 'tramp-remote-path "$HOME/go/bin")

必须写完整路径：

(add-to-list 'tramp-remote-path "/home/you/go/bin")

**如果你的用户名在不同机器上不一样**，或者主目录路径不统一（有的是 /home/xxx ，有的是 /u/xxx ），就得把所有可能的路径都加上：

(dolist (dir '("/home/you/go/bin"
               "/home/you/.local/bin"
               "/u/you/go/bin"))
  (add-to-list 'tramp-remote-path dir))

**如果你想直接用远程机器自己的 $PATH=**，可以把 =tramp-own-remote-path 加到 tramp-remote-path 里：

(add-to-list 'tramp-remote-path 'tramp-own-remote-path)

这会让 Tramp 在远程机器上运行 /bin/sh -l -c 'echo $PATH' 来获取路径。前提是你的 .profile 在非交互式执行时不能出问题，比如不能有 read 等待输入、不能有 select 菜单、不能因为检测不到终端就报错退出。

Tramp 不是 mode，没有 tramp-mode-hook 。它是一个在你第一次访问远程文件路径时才加载的模块。所以你不能在加载之前就指望配置生效，也不能用 with-eval-after-load 之前的 setq 来设置某些变量。

use-package 的 :config 块正好在包加载后执行，是挂载 Tramp 配置的好地方：

(use-package tramp
  :defer t
  :config
  ;; 禁用持久化缓存
  (setq tramp-persistency-file-name nil)
  ;; 添加自定义远程路径
  (dolist (dir '("/home/you/go/bin"
                 "/home/you/.local/bin"))
    (add-to-list 'tramp-remote-path dir))
  ;; 清理已有的缓存连接
  (tramp-cleanup-all-connections))

如果你不用 use-package ，等价写法是：

(with-eval-after-load 'tramp
  (setq tramp-persistency-file-name nil)
  (dolist (dir '("/home/you/go/bin"
                 "/home/you/.local/bin"))
    (add-to-list 'tramp-remote-path dir))
  (tramp-cleanup-all-connections))