多语言单体仓库中lsp-mode选择错误项目根路径的问题排查

核心问题定位 #

你遇到的本质是LSP工作区的层级覆盖：当把仓库根目录设为Go工作区后，所有子目录都会被这个工作区包含，导致rust-analyzer这类工具默认继承父级工作区，不会触发根目录选择提示。另外Projectile的全局根识别逻辑会进一步强化这个问题，因为它默认把git根当作项目根。

具体解决方案 #

1. 用.dir-locals.el强制指定子项目的LSP根 #

这是最直接的手动控制方法，完全规避自动猜测的不确定性：

• 在仓库根目录的.dir-locals.el中，给Go项目锁死根目录：

  ((go-mode . ((lsp-workspace-root . "/path/to/your/repo-root")
               (lsp-clients-gopls-args . ("-remote=auto")))))
  

• 在每个Rust子项目的根目录（比如repo-root/rust-proj1/）下创建.dir-locals.el：

  ((rust-mode . ((lsp-workspace-root . "/path/to/your/repo-root/rust-proj1")
                 (lsp-rust-analyzer-cargo-watch-command . "check"))))
  

  打开Rust文件时，LSP会直接用当前子目录作为工作区，不会继承父级的Go工作区。

2. 禁用Projectile对特定语言的根干扰 #

不想弃用Projectile的话，可给不同语言设置专属根识别规则，避免一刀切用git根：

• 让Rust项目优先识别Cargo.toml作为根：

  (setq projectile-project-root-functions
        (append '(projectile-root-from-cargo-toml)
                projectile-project-root-functions))
  

• 给Go项目保留go.mod/git根的识别逻辑：

  (defun projectile-root-from-go-mod ()
    (when (memq major-mode '(go-mode go-dot-mod-mode))
      (locate-dominating-file default-directory "go.mod")))
  (add-to-list 'projectile-project-root-functions 'projectile-root-from-go-mod t)
  

  这样Projectile会根据当前打开的文件类型自动匹配对应根目录。

3. 手动控制LSP工作区加载顺序 #

如果上述方法仍有冲突，可通过钩子函数控制工作区添加时机：

• 打开Go文件时自动添加根工作区：

  (add-hook 'go-mode-hook
            (lambda ()
              (let ((repo-root (locate-dominating-file default-directory "go.mod")))
                (unless (member repo-root lsp-workspace-folders)
                  (lsp-workspace-folders-add repo-root)))))
  

• 打开Rust文件时先加载子项目工作区，延迟恢复Go根工作区：

  (add-hook 'rust-mode-hook
            (lambda ()
              (let* ((rust-root (locate-dominating-file default-directory "Cargo.toml"))
                     (repo-root (locate-dominating-file default-directory ".git")))
                (unless (member rust-root lsp-workspace-folders)
                  (lsp-workspace-folders-add rust-root))
                ;; 临时移除父级Go工作区避免覆盖
                (when (member repo-root lsp-workspace-folders)
                  (lsp-workspace-folders-remove repo-root))
                ;; 启动rust-analyzer后恢复Go工作区
                (run-with-timer 1 nil
                                (lambda ()
                                  (unless (member repo-root lsp-workspace-folders)
                                    (lsp-workspace-folders-add repo-root)))))))
  

4. 极端验证：暂时禁用Projectile #

如果怀疑是Projectile的问题，可先完全禁用验证：

(setq projectile-mode nil)
(global-projectile-mode -1)

手动添加工作区后看问题是否消失，若消失再回到方案2针对性修改配置即可，无需完全弃用。

关键注意事项 #

• 确保lsp-auto-guess-root始终设为nil，所有工作区由手动控制。
• 修改配置后，重启Emacs或用lsp-restart-workspace刷新工作区，避免缓存影响。
• TS/Python项目可参考Rust的配置，用package.json/requirements.txt作为根标志，在.dir-locals.el中指定对应LSP根。

内容的提问来源于stack exchange，提问作者user4601931