如何让Windows下的EXE程序找到指定文件夹中的DLL文件

核心思路 #

Windows系统默认会在EXE所在目录、系统目录以及PATH环境变量包含的路径中查找DLL。要实现DLL单独存放，需要两步：

1. 配置CMake将DLL输出到指定的独立文件夹
2. 让EXE运行时能识别到这个文件夹（调试阶段通过IDE环境变量，发布阶段通过PATH或部署配置）

修改后的CMake配置 #

主CMakeLists.txt #

cmake_minimum_required(VERSION 3.26)

project(mathlearning)

# 编译选项
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall -Wextra -g")

# 统一输出目录：
# - EXE 输出到 bin 目录
# - DLL 输出到 bin/libs 目录
# - 静态库 输出到 lib 目录
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${PROJECT_BINARY_DIR}/bin)
set(CMAKE_LIBRARY_OUTPUT_DIRECTORY ${PROJECT_BINARY_DIR}/bin/libs)
set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY ${PROJECT_BINARY_DIR}/lib)

add_subdirectory(math_lib)
add_subdirectory(print_lib)

add_executable(mathlearning main.cpp)
target_link_libraries(mathlearning math_lib print_lib)

# Windows调试阶段：自动将DLL目录加入PATH，让IDE运行EXE时能找到DLL
if(WIN32)
  set_target_properties(mathlearning PROPERTIES
    VS_DEBUGGER_ENVIRONMENT "PATH=${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/libs;%PATH%"
  )
endif()

print_lib/CMakeLists.txt（可选优化） #

如果需要单独指定这个DLL的输出路径（覆盖全局设置），可以添加以下配置：

add_library(print_lib SHARED print_lib.cpp)
target_link_libraries(print_lib math_lib)

# 强制将该DLL输出到bin/libs目录
set_target_properties(print_lib PROPERTIES
  RUNTIME_OUTPUT_DIRECTORY ${PROJECT_BINARY_DIR}/bin/libs
)

关键配置说明 #

1. 输出目录规划：通过CMAKE_RUNTIME_OUTPUT_DIRECTORY等变量统一管理不同类型文件的输出位置，让项目结构更整洁，符合专业软件的目录规范。
2. 调试阶段PATH设置：VS_DEBUGGER_ENVIRONMENT会告诉Visual Studio在调试运行EXE时，自动把bin/libs目录加入系统PATH，这样无需手动复制DLL到EXE目录。
3. 发布阶段处理：
   • 打包时将bin目录（含EXE）和bin/libs目录一起分发
   • 可以编写批处理文件启动EXE，在脚本中先执行set PATH=%~dp0libs;%PATH%，再运行EXE
   • 或者使用Windows的Side-by-Side部署（通过manifest文件指定DLL路径）

你原配置的问题 #

原CMake代码没有指定DLL的输出目录，也没有配置运行时的DLL查找路径，导致系统只能在EXE同目录下找到DLL，无法识别单独的文件夹。

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