0

0

如何在c++中编写符合C++ Core Guidelines的代码? (现代化准则)

尼克

尼克

发布时间:2026-01-11 15:14:02

|

251人浏览过

|

来源于php中文网

原创

应使用 std::span 替代裸指针+长度参数,因其类型安全、编译期推导、零开销;禁用 new/delete,改用栈变量、std::array、std::vector、std::unique_ptr 等 RAII 方式;输入参数优先 const T& 或 T,避免非常量引用;启用 clang-tidy/CppCoreCheck 等静态检查并设为 error。

如何在c++中编写符合c++ core guidelines的代码? (现代化准则)

std::span 替代裸指针 + 长度参数

Core Guidelines 明确反对 T* + size_t 这种容易脱节的组合。传参时一不留神就忘记检查长度,或把指针和长度传错顺序。

改用 std::span 能让边界安全内建在类型里,编译期可推导,运行时零开销:

void process_data(std::span data) {
    for (int x : data) { /* 安全遍历 */ }
}

// 调用方自然适配 std::vector v = {1, 2, 3}; process_data(v); // OK:隐式转 span int arr[] = {4, 5}; process_data(arr); // OK:推导出长度为 2 process_data({ptr, len}); // OK:显式构造(但应尽量避免裸 ptr 构造)

注意:不要用 std::span 包裹堆分配内存(如 new int[n]),因为 std::span 不拥有资源,析构时不释放;此时该用 std::unique_ptr 或容器。

禁止使用 new/delete 手动管理内存

Core Guidelines 的 R.11 直接写明:“Don’t call new or delete explicitly”。裸 new 容易导致泄漏、异常安全问题,且无法与 RAII 自然衔接。

立即学习C++免费学习笔记(深入)”;

替代方案按场景选择:

  • 固定大小、上足够 → 直接用栈变量或 std::array
  • 动态大小、需自动管理 → 优先用 std::vectorstd::string
  • 需要独占堆资源且不共享 → 用 std::unique_ptrstd::unique_ptr
  • 必须共享所有权 → 仅当明确需要时才用 std::shared_ptr,并避免循环引用

错误示例:

int* p = new int{42};
// 忘记 delete?异常跳过?都危险
return *p;
正确写法:
return std::make_unique(42); // 返回 unique_ptr,所有权清晰

函数参数优先用 const T&T,禁用 T& 输入参数

Core Guidelines 的 F.16 规定:输入参数应是只读的,除非函数语义明确要求修改调用方状态。用非 const 引用作输入,既破坏接口可读性,又阻碍传入字面量或临时对象。

ClippingMagic
ClippingMagic

魔术般地去除图片背景

下载

常见误用:

void set_name(std::string& name); // ❌ name 是输入还是输出?不能传 "alice" 字面量
set_name("alice"); // 编译失败:不能绑定非常量引用到右值

正确方式:

  • 只读输入 → const std::string&(大对象)或 std::string(小对象,现代编译器 RVO/NRVO 优化充分)
  • 输出参数 → 显式用输出参数名(如 std::string& out_name),或更推荐返回值(std::string compute_name()
  • 移动语义输入 → 若函数要“吃掉”参数,用 std::string&&(但极少用于普通函数,多见于构造/赋值)

启用编译器静态检查并配置 /permissive-(MSVC)或 -pedantic(Clang/GCC)

Core Guidelines 不是道德规范,而是可被工具链验证的工程实践。不靠人工 review,而靠 clang-tidyCppCoreCheck(VS)、include-what-you-use 等工具落地。

关键操作:

  • Clang/GCC:加 -Wconversion -Wduplicated-cond -Wfloat-equal -Wnon-virtual-dtor 等,再配合 clang-tidy -checks="cppcoreguidelines-*"
  • MSVC:项目属性中启用 C++ Core Check,并确保 /permissive- 关闭非标准扩展(比如隐式 int 返回、宽窄字符串混用)
  • 所有项目:把 #include std::span 等现代设施纳入构建,别让团队还在用自定义 ArrayView 封装

最容易被忽略的一点:很多团队开了 clang-tidy,但没把检查结果设为 error,或者没集成进 CI。只要有一处 warning 被放过,规则就形同虚设。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

315

2023.08.02

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1463

2023.10.24

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

187

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

271

2023.10.25

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

520

2023.09.20

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

253

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

206

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1463

2023.10.24

c++主流开发框架汇总
c++主流开发框架汇总

本专题整合了c++开发框架推荐,阅读专题下面的文章了解更多详细内容。

80

2026.01.09

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 3.5万人学习

Pandas 教程
Pandas 教程

共15课时 | 0.9万人学习

ASP 教程
ASP 教程

共34课时 | 3.4万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号