VS2015编译cuBLAS示例代码遇外部符号未解析问题求助

云原生阿岚

2026-5-20

解决VS2015中cuBLAS代码编译时外部符号未解析的问题

嘿，我看到你在VS2015里编译cuBLAS官方示例代码（0-based索引那个）时碰到了外部符号未解析的错误，这在CUDA项目配置里是非常常见的问题，不用慌，咱们一步步来排查解决。

错误原因分析

外部符号未解析本质上是编译器/链接器找不到cuBLAS库中定义的函数实现，通常是因为项目没有正确配置CUDA的库路径，或者没有链接对应的cuBLAS库文件，也有可能是项目平台和CUDA版本不匹配导致的。

具体解决步骤

1. 确认CUDA Toolkit版本与VS2015兼容

VS2015只支持CUDA 8.0到CUDA 10.0左右的版本（太新的CUDA版本已经放弃对VS2015的支持），如果你的CUDA版本不符合，建议降级到兼容版本，或者升级VS（不过你既然用VS2015，优先选兼容的CUDA版本）。

2. 配置项目的包含目录

右键你的项目 → 属性 → 配置属性 → VC++目录 → 包含目录，添加CUDA的头文件路径：

$(CUDA_PATH)\include

这样编译器才能找到cublas_v2.h这类头文件。

3. 配置项目的库目录

同样在VC++目录 → 库目录，添加CUDA的库文件路径：

$(CUDA_PATH)\lib\x64

如果你的项目是32位的，就换成$(CUDA_PATH)\lib\x86，现在大部分场景都是64位项目，优先选x64。

4. 链接cuBLAS库文件

右键项目 → 属性 → 配置属性 → 链接器 → 输入 → 附加依赖项，添加以下库文件：

cublas.lib
cublas_device.lib

或者你也可以直接在代码开头加一行，手动告诉链接器要链接的库，这样不用改项目配置：

#pragma comment(lib, "cublas.lib")
#pragma comment(lib, "cublas_device.lib")

5. 检查项目平台是否匹配

VS默认新建的项目可能是Win32平台，但你装的CUDA大概率是64位的，这时候会因为找不到64位库导致符号未解析。切换平台的方法：
菜单栏 → 生成 → 配置管理器 → 活动解决方案平台 → 新建 → 选择x64并设置为默认平台。

6. 确保代码完整

你贴的代码看起来没写完（比如modify函数的参数float alpha...后面缺少内容），官方示例2的完整代码应该是这样的，你可以替换成完整代码再编译：

//Example 2. Application Using C and CUBLAS: 0-based indexing
//-----------------------------------------------------------
#include <stdio.h>
#include <stdlib.h>
#include <math.h>
#include <cuda_runtime.h>
#include "cublas_v2.h"

#define M 6
#define N 5
#define IDX2C(i,j,ld) (((j)*(ld))+(i))

static __inline__ void modify(cublasHandle_t handle, float *m, int ldm, int n, int p, int q, float alpha)
{
    cublasSscal(handle, n-p, &alpha, &m[IDX2C(p,p,ldm)], ldm+1);
    if (q > p) {
        cublasSscal(handle, q-p, &alpha, &m[IDX2C(p,p+1,ldm)], ldm+1);
        cublasSscal(handle, q-p, &alpha, &m[IDX2C(p+1,p,ldm)], ldm+1);
    }
}

int main()
{
    cublasHandle_t handle;
    float *A, *x, *y;
    float alpha = 1.0f, beta = 0.0f;
    int i, j;

    cublasCreate(&handle);
    A = (float *)malloc(M*N*sizeof(float));
    x = (float *)malloc(N*sizeof(float));
    y = (float *)malloc(M*sizeof(float));

    for (j = 0; j < N; j++) {
        for (i = 0; i < M; i++) {
            A[IDX2C(i,j,M)] = (float)(i*N+j);
        }
    }
    for (i = 0; i < N; i++) {
        x[i] = (float)i;
    }
    for (i = 0; i < M; i++) {
        y[i] = (float)0;
    }

    printf("A:\n");
    for (i = 0; i < M; i++) {
        for (j = 0; j < N; j++) {
            printf("%7.0f", A[IDX2C(i,j,M)]);
        }
        printf("\n");
    }
    printf("x:\n");
    for (i = 0; i < N; i++) {
        printf("%7.0f", x[i]);
    }
    printf("\n");
    printf("y:\n");
    for (i = 0; i < M; i++) {
        printf("%7.0f", y[i]);
    }
    printf("\n");

    cublasSgemv(handle, CUBLAS_OP_N, M, N, &alpha, A, M, x, 1, &beta, y, 1);

    printf("y after gemv:\n");
    for (i = 0; i < M; i++) {
        printf("%7.0f", y[i]);
    }
    printf("\n");

    modify(handle, A, M, N, 1, 4, 2.0f);

    printf("A after modify:\n");
    for (i = 0; i < M; i++) {
        for (j = 0; j < N; j++) {
            printf("%7.0f", A[IDX2C(i,j,M)]);
        }
        printf("\n");
    }

    cublasSgemv(handle, CUBLAS_OP_N, M, N, &alpha, A, M, x, 1, &beta, y, 1);

    printf("y after modified gemv:\n");
    for (i = 0; i < M; i++) {
        printf("%7.0f", y[i]);
    }
    printf("\n");

    free(A);
    free(x);
    free(y);
    cublasDestroy(handle);
    return EXIT_SUCCESS;
}

最后验证

按照上面的步骤配置完成后，重新编译项目，应该就能顺利通过了。如果还是有问题，可以检查一下CUDA的环境变量是否正确（CUDA_PATH是否指向你的CUDA安装目录）。

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