点击 <C 语言编程核心突破> 快速C语言入门
VS2022使用modules
- 前言
- 一、准备
- 二、使用
-
-
- [其一, 用VS installer 安装模块:](#其一, 用VS installer 安装模块:)
- [第二个选项就是, 与你的代码一同编译std模块, 这个非常简单, 但是也有坑.](#第二个选项就是, 与你的代码一同编译std模块, 这个非常简单, 但是也有坑.)
-
- 总结
前言
要解决问题: 使用VS2022开启modules.
想到的思路: 跟着官方文档整.
其它的补充: 挺麻烦, 完成后很好玩.
一、准备
**注意: 本教程需要 Visual Studio 2022 17.5 或更高版本.**
检查你的VS版本:
打开cmd终端, 以下内容需要命令行进行:
先创建一个目录存放标准模块, 比如:
bash
E:\clangC++
在cmd中, 使其成为当前目录:
使用以下命令编译命名模块:std
bash
E:\clangC++> cl /std:c++latest /EHsc /nologo /W4 /c "%VCToolsInstallDir%\modules\std.ixx"
注意, 以上命令一定会出错, 因为系统没有%VCToolsInstallDir%
, 你要找, 比如我的就在:
E:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.35.32215\modules
无论用什么查找命令, 找到他, 然后替换过去.
实在找不到, 把这个存成std.ixx
, 放到你建立的要放标准模块的目录下, 然后将"%VCToolsInstallDir%\modules\std.ixx"
换成"std.ixx"
:
bash
// Copyright (c) Microsoft Corporation.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
// This named module expects to be built with classic headers, not header units.
#define _BUILD_STD_MODULE
module;
// The subset of "C headers" [tab:c.headers] corresponding to
// the "C++ headers for C library facilities" [tab:headers.cpp.c]
#include <assert.h>
#include <ctype.h>
#include <errno.h>
#include <fenv.h>
#include <float.h>
#include <inttypes.h>
#include <limits.h>
#include <locale.h>
#include <math.h>
#include <setjmp.h>
#include <signal.h>
#include <stdarg.h>
#include <stddef.h>
#include <stdint.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <time.h>
#include <uchar.h>
#include <wchar.h>
#include <wctype.h>
export module std;
#pragma warning(push)
#pragma warning(disable : 5244) // '#include <meow>' in the purview of module 'std' appears erroneous.
// "C++ library headers" [tab:headers.cpp]
#include <algorithm>
#if _HAS_STATIC_RTTI
#include <any>
#endif // _HAS_STATIC_RTTI
#include <array>
#include <atomic>
#include <barrier>
#include <bit>
#include <bitset>
#include <charconv>
#include <chrono>
#include <codecvt>
#include <compare>
#include <complex>
#include <concepts>
#include <condition_variable>
#include <coroutine>
#include <deque>
#include <exception>
#include <execution>
#include <expected>
#include <filesystem>
#include <format>
#include <forward_list>
#include <fstream>
#include <functional>
#include <future>
#include <initializer_list>
#include <iomanip>
#include <ios>
#include <iosfwd>
#include <iostream>
#include <istream>
#include <iterator>
#include <latch>
#include <limits>
#include <list>
#include <locale>
#include <map>
#include <memory>
#include <memory_resource>
#include <mutex>
#include <new>
#include <numbers>
#include <numeric>
#include <optional>
#include <ostream>
#include <queue>
#include <random>
#include <ranges>
#include <ratio>
#include <regex>
#include <scoped_allocator>
#include <semaphore>
#include <set>
#include <shared_mutex>
#include <source_location>
#include <span>
#include <spanstream>
#include <sstream>
#include <stack>
#include <stacktrace>
#include <stdexcept>
#include <stop_token>
#include <streambuf>
#include <string>
#include <string_view>
#include <strstream>
#include <syncstream>
#include <system_error>
#include <thread>
#include <tuple>
#include <type_traits>
#include <typeindex>
#include <typeinfo>
#include <unordered_map>
#include <unordered_set>
#include <utility>
#include <valarray>
#include <variant>
#include <vector>
#include <version>
// "C++ headers for C library facilities" [tab:headers.cpp.c]
#include <cassert>
#include <cctype>
#include <cerrno>
#include <cfenv>
#include <cfloat>
#include <cinttypes>
#include <climits>
#include <clocale>
#include <cmath>
#include <csetjmp>
#include <csignal>
#include <cstdarg>
#include <cstddef>
#include <cstdint>
#include <cstdio>
#include <cstdlib>
#include <cstring>
#include <ctime>
#include <cuchar>
#include <cwchar>
#include <cwctype>
#pragma warning(pop)
再次运行命令, 不出意外仍然报错:
bash
E:\clangC++> cl /std:c++latest /EHsc /nologo /W4 /c "std.ixx"
没有包含路径集
找到VsDevCmd.bat
这个文件, 通常在:
bash
E:\Program Files\Microsoft Visual Studio\2022\Community\Common7\Tools
把它拉进cmd
命令行运行, 也就是建立路径集
然后运行模块命令, 在你的目录下会产生两个文件: std.ifc
, std.obj
就OK了.
如法炮制, 建立全局C函数模块
bash
E:\clangC++> cl /std:c++latest /EHsc /nologo /W4 /c "std.ixx" "std.compat.ixx"
又多了两个文件: std.compat.ifc
, std.compat.obj
或者直接用Developer Command Prompt for VS 2022
, 它直接将VS
编译环境集成了:
如果想在vscode
中调试VS
编译的程序, 就需要从这个环境中的终端以code .
命令启动vscode
程序, 具体的内容比较多, 请参考Configure VS Code for Microsoft C++, 英文的, 说的比较明白.
二、使用
在使用时候, 我遇到了大麻烦, 就是无数的报错, 经过各种搜索, 发现, 问题很简单, 要使用模块, 那么编译命令必须与编译模块的命令是一致的, 如有更改, 则模块失效.
所以, 如果你想用刚才的模块编译, 必须使用命令行:
bash
E:\clangC++> cl /c /std:c++latest /EHsc /nologo /W4 /reference "std=std.ifc" Example.cpp
link Example.obj std.obj
否则, 必须重新编译模块, 这是因为模块是二进制的状态, 改动编译命令后, 二进制不兼容, 这个无解.
当然, 对于std
模块, 微软还算有良心, 你有两个选择,
其一, 用VS installer 安装模块:
然后通过
c
import std.core;
引入标准库的内容, 具体如下:
bash
std.regex 提供标头 <regex> 的内容
std.filesystem 提供标头 <filesystem> 的内容
std.memory 提供标头 <memory> 的内容
std.threading 提供标头 <atomic>、<condition_variable>、<future>、<mutex>、<shared_mutex> 和 <thread> 的内容
std.core 提供 C++ 标准库中的任何其他内容
使用的时候要打开项目的C++标准和模块选项:
然后就可以愉快的编译了, 忘了说了, 我的VS使用模块后, 所有代码提示及补全都没有了, 是的, 都用不了了 !
c
import std.core;
int main()
{
for (size_t i = 0; i < 5; i++)
{
std::cout << "hello";
}
return 0;
}
所以, 模块的路还很长.
第二个选项就是, 与你的代码一同编译std模块, 这个非常简单, 但是也有坑.
把这个文件std.ixx
拷贝到你的项目目录中, 在编译时, 增加一个命令行:
这时, 编译器会在链接前生成模块, 并且由于编译命令完全一致, 所以就不太会出错了, 当然我还是碰到下面的小问题, 好在解决了:
要确定不要开优化
. 开了出错的概率很大.
在编译完成后, 如果日后你要使用同样的编译命令, 则可以直接连接模块了, 通过下面的命令:
还有连接器:
完活, 收工 !
2024-05-24 升级VS到最新版本, 代码提示和补全功能又回来了, 人类, 总是这要, 那要, 还要, 然后有需求, 就有满足.
总结
对于模块的支持, VS算是比较靠前了, 然而, 还是有坑, 坑要一个一个的踩.
我只能帮你到这了, 剩下的路, 自己慢慢踩吧.
点击 <C 语言编程核心突破> 快速C语言入门