如何解决CLR类库与CLR控制台应用链接时的LNK1302错误？

问题背景 #

我有一个VS2026解决方案，包含三个项目：核心为纯C库，GUI是提供.NET平台功能的C/CLI Windows Form可执行文件，第三个是为GUI提供输入的核心包装器。构建GUI时出现LNK1302错误：only support linking safe .netmodules; unable to link ijw/native .netmodule。

为模拟该问题，我创建了两个极简项目：一个是模拟包装器的CLR类库项目，另一个是调用它的CLR控制台应用，但构建控制台应用时仍触发相同错误。尝试改用/clr:safe编译会产生大量错误，求可行的协作方案。

模拟项目代码 #

1. SimpleClassLibrary（CLR类库项目） #

SimpleClassLibrary.h

#pragma once

using namespace System;

namespace SimpleClassLibrary 
{
    public ref class Class1
    {
        String^ str {"Hello World!"};
    public:
        Class1 () {}
        String^ GetString () {return str;}
        void SetString (String^ s) {str = s;}
    };
}

SimpleClassLibrary.cpp

#include "pch.h"
#include "SimpleClassLibrary.h"

2. SimpleConsoleApplication（CLR控制台应用） #

SimpleConsoleApplication.cpp

#include "pch.h"

using namespace System;

#include "SimpleClassLibrary.h"

int main (array<System::String ^> ^args)
{
    SimpleClassLibrary::Class1^ simple = 
        gcnew SimpleClassLibrary::Class1 ();
    String^ str = simple->GetString ();
    System::Console::WriteLine (str);

    return 0;
}

项目配置参数 #

解决方案 #

错误根源 #

你在控制台项目中直接将SimpleClassLibrary.dll添加为链接依赖，但C++/CLI混合程序集不能通过传统的原生链接方式引用，链接器会误将其识别为非安全的.netmodule，从而触发LNK1302错误。

修复步骤 #

1. 移除错误的链接依赖：打开控制台项目属性，删除链接器→输入中的SimpleClassLibrary.dll附加依赖项，若该依赖是附加库目录的唯一用途，也可清空该配置项。
2. 添加项目引用：右键控制台项目 → 添加→引用，在弹出窗口的项目标签下勾选SimpleClassLibrary项目，点击确定。VS会自动处理程序集的引用、编译顺序和输出依赖。
3. 统一配置兼容性：确保两个项目的平台工具集、.NET目标框架版本完全一致，避免跨版本的托管/原生代码兼容性问题。
4. 清理重建：清理整个解决方案，然后重新生成所有项目。

关于/clr:safe的说明 #

/clr:safe要求代码完全是托管代码，不允许包含任何原生C逻辑，但你的包装器项目需要调用纯C核心库，必然包含原生代码，因此无法使用该编译选项，这也是切换后报错的核心原因。

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