为Conda安装的Pybind11配置VSCode及Emacs/Clangd的C++包含路径

问题根源 #

VSCode主进程未激活conda环境，导致${CONDA_PREFIX}环境变量未被加载，因此无法解析对应路径。

可行解决方法 #

方法1：从激活conda环境的终端启动VSCode #

• 打开终端，激活目标conda环境：conda activate your_env_name
• 在该终端中运行code .打开项目目录
• 此时VSCode会继承终端的环境变量，${CONDA_PREFIX}/include即可被正确解析

方法2：通过Python解释器路径推导include目录 #

如果不想每次从终端启动，可利用VSCode Python扩展的内置变量，修改c_cpp_properties.json为：

{
    "configurations": [
        {
            "name": "Linux",
            "includePath": [
                "${workspaceFolder}/**",
                "${command:python.interpreterPath}/../../include"
            ],
            "defines": [],
            "compilerPath": "/usr/bin/clang",
            "cStandard": "c17",
            "cppStandard": "c++20",
            "intelliSenseMode": "linux-clang-x64"
        }
    ],
    "version": 4
}

注：${command:python.interpreterPath}指向当前项目选中的Python解释器路径，../../include是从bin/python向上两级定位到conda环境根目录的include文件夹，适配绝大多数conda环境结构。

核心思路 #

确保Clangd能获取conda环境的include路径，同时Emacs进程需加载CONDA_PREFIX环境变量。

方法1：从激活conda环境的终端启动Emacs #

• 终端中激活目标环境：conda activate your_env_name
• 运行emacs启动编辑器，Clangd会自动继承终端的环境变量

方法2：直接配置Clangd参数 #

在Emacs配置文件（如~/.emacs或~/.emacs.d/init.el）中添加：

;; 配置Clangd额外包含路径
(setq lsp-clients-clangd-args
      '("-I${CONDA_PREFIX}/include"
        "--compile-commands-dir=${workspaceFolder}"))

若Emacs未自动加载CONDA_PREFIX，可手动指定环境路径：

;; 手动设置conda环境根路径
(setenv "CONDA_PREFIX" "/home/your_name/miniconda3/envs/your_env_name")
(setq lsp-clients-clangd-args
      '("-I/home/your_name/miniconda3/envs/your_env_name/include"
        "--compile-commands-dir=${workspaceFolder}"))

方法3：通过compile_commands.json传递路径 #

如果项目使用CMake，可在CMakeLists.txt中添加以下代码自动获取conda环境的include路径：

find_package(Python REQUIRED COMPONENTS Interpreter)
execute_process(
    COMMAND ${Python_EXECUTABLE} -c "import sysconfig; print(sysconfig.get_path('include'))"
    OUTPUT_VARIABLE PYTHON_INCLUDE_DIR
    OUTPUT_STRIP_TRAILING_WHITESPACE
)
include_directories(${PYTHON_INCLUDE_DIR})

生成compile_commands.json后，Clangd会自动读取其中的包含路径。

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