Git提交前的必备神器——自动清除调试语句脚本

说在前面

不知道大家有没有遇到这样一种情况，平时在写代码调试时有时候会使用到debugger，可能大部分时间在提交代码前会记得把debugger先删除，但可能也会存在将debugger提交上去的情况，那我们该怎么防止出现这种情况呢？

当要提交代码时，通常会避免将调试语句debugger一同提交到版本库中。为了解决这个问题，你编写了一个脚本来自动清除代码中的debugger语句，并将修改后的文件添加到Git暂存区。在这篇博客中，我们将介绍这个脚本的实现原理和使用方法，帮助开发者更有效地管理和提交代码。

webpack 配置修改

开发过程中，经常需要使用console.log、console.info、alert等操作来输出内容，测试代码，而在生产环境之中，这些打印的东西最好是不要显示、特别是用户名、密码相关。

一个个去删除、注释显然是很麻烦的一件事，所以我们可以通过修改配置变量，实现在开发环境打印，而生产环境不打印。

修改方法如下：
在项目的build/webpack.prod.conf.js文件之中，找到UglifyJsPlugin配置，在compress中添加如下代码即可。

new UglifyJsPlugin({uglifyOptions: { compress: { warnings: false, // 打包的时候移除console、debugger drop_debugger: true, // 移除debugger drop_console: true, // 移除console pure_funcs: ['console.log','console.info']}},sourceMap: config.build.productionSourceMap,parallel: true
}),

git hook监测删除

除了直接在webpack中配置之外，我们还可以在git提交前进行监测，将修改文件中的相关语句清除，这里以清除修改文件中的debugger语句为例子：

git hook简单了解

Git钩子是一组脚本，这些脚本对应着Git仓库中的特定事件，每一次事件发生时，钩子会被触发。这允许你可以定制化Git的内部行为，在开发周期中的关键点上触发执行定制化的脚本。

image.png

钩子脚本文件通常放置于项目目录的.git/hooks文件夹下。Git会在初始化项目时自动在这个文件夹下放置一些样例脚本。如果你查看.git/hooks文件夹下，会找到如下的文件：

image.png

我们可以简单了解一下这些钩子的触发时机：

  • applypatch-msg

这个钩子由git-am调用。它接受一个参数，即保存提议的提交日志消息的文件的名称。以非零状态退出导致git am在应用补丁之前中止。

允许钩子就地编辑消息文件，并可用于将消息规范化为某种项目标准格式。它还可以用于在检查消息文件后拒绝提交。

默认的applypatch-msg钩子在启用时，如果启用了commit-msg钩子，则运行commit-msg钩子。

  • commit-msg

这个钩子由git-commit和git-merge调用，可以通过——no-verify选项绕过。它接受一个参数，即保存提议的提交日志消息的文件的名称。以非零状态退出将导致命令中止。

允许钩子就地编辑消息文件，并可用于将消息规范化为某种项目标准格式。它还可以用于在检查消息文件后拒绝提交。

默认的commit-msg钩子在启用时，会检测到重复的挂件签到，如果发现了，就会中止提交。

  • fsmonitor-watchman

这个钩子在配置选项核心时被调用。根据要使用的钩子的版本，Fsmonitor被设置为.git/hooks/ Fsmonitor -watchman或.git/hooks/ Fsmonitor -watchmanv2。

Version 1有两个参数，一个是Version(1)，另一个是自1970年1月1日午夜以来经过的纳秒时间。

Version 2有两个参数，一个是Version(2)，另一个是token(用于标识token之后的更改)。对于守望者来说，这是一个时钟id。这个版本必须在文件列表之前向stdout输出新的令牌，后跟一个NUL。

钩子应该向stdout输出工作目录中自请求时间以来可能发生更改的所有文件的列表。逻辑应该是包容性的，这样它就不会错过任何潜在的更改。这些路径应该是相对于工作目录的根目录的，并由单个NUL分隔。

包含实际上没有更改的文件是可以的。应该包括所有更改，包括新创建和删除的文件。当重命名文件时，应该同时包含旧的和新的名称。

Git将根据给定的路径名限制检查更改的文件，以及检查未跟踪文件的目录。

告诉git“所有文件都已更改”的一种优化方法是返回文件名/。

退出状态决定git是否会使用来自钩子的数据来限制它的搜索。如果出现错误，它将退回到验证所有文件和文件夹。

  • post-update

当git-receive-pack响应git push并更新其存储库中的引用时，会调用该钩子。当所有引用都被更新后，它会在远程存储库上执行一次。

它接受可变数量的参数，每个参数都是实际更新的ref的名称。

这个钩子主要用于通知，不会影响git receive-pack的结果。

post-update钩子可以告诉我们被推送的头是什么，但它不知道它们的原始值和更新值是什么，所以这是一个糟糕的地方。post-receive钩子获取ref的原始值和更新后的值。如果你需要的话，你可以考虑一下。

当启用时，默认的post-update钩子会运行git update-server-info来保持哑传输(例如HTTP)使用的信息是最新的。如果你要发布一个可以通过HTTP访问的Git存储库，你应该启用这个钩子。

标准输出和标准错误输出都被转发到另一端的git send-pack，因此您可以简单地为用户回显消息。

  • pre-commit

这个钩子由git-commit调用，可以通过——no-verify选项绕过。它不接受任何参数，在获得建议的提交日志消息并进行提交之前调用。以非零状态退出该脚本会导致git commit命令在创建提交之前终止。

默认的预提交钩子在启用时，会捕获带有尾随空格的行，并在找到这样的行时中止提交。

所有的git提交钩子都是用环境变量GIT_EDITOR=:来调用的，如果这个命令不会调出一个编辑器来修改提交消息。

默认的预提交钩子(当启用时)和钩子。allownonascii配置选项取消设置或设置为false -防止使用非ascii文件名。

  • pre-merge-commit

这个钩子由git-merge调用，可以用——no-verify选项绕过。它不接受任何参数，并且在成功执行合并之后，在获得建议的提交日志消息以进行提交之前调用。以非零状态退出该脚本会导致git merge命令在创建提交之前终止。

默认的预合并提交钩子在启用时，如果启用了预提交钩子，则运行预提交钩子。

如果该命令不会调出编辑器来修改提交消息，则使用环境变量GIT_EDITOR=:调用该钩子。

如果合并不能自动执行，则需要解决冲突并单独提交结果(参见git-merge[1])。此时，此钩子将不会被执行，但如果启用了预提交钩子，则会执行。

  • prepare-commit-msg

这个钩子被git-commit调用，在准备默认日志消息之后，在编辑器启动之前。

它需要一到三个参数。第一个是包含提交日志消息的文件的名称。第二个是提交消息的来源，可以是:message(如果给出了-m或-F选项);模板(如果给出了-t选项或配置选项commit)。模板设置);merge(如果提交是merge或者.git/MERGE_MSG文件存在);(如果.git/SQUASH_MSG文件存在);或commit，后跟提交对象名称(如果给出了-c、-c或——amend选项)。

如果退出状态非零，git commit将中止。

钩子的目的是就地编辑消息文件，它不会被——no-verify选项抑制。非零退出意味着钩子失败并终止提交。它不应该被用作预提交钩子的替代品。

Git附带的样例prepare-commit-msg钩子删除了提交模板注释部分中的帮助消息。

  • pre-push

这个钩子由git-push调用，可以用来阻止push的发生。钩子是用两个参数调用的，这两个参数提供了目标远程的名称和位置，如果没有使用命名的远程，两个值将是相同的。

关于要推送的内容的信息在钩子的标准输入中提供，格式如下:

<local ref> SP <local object name> SP <remote ref> SP <remote object name> LF
例如，如果命令git push origin master:foreign被运行，钩子会收到像下面这样的一行:

参考/头/主67890参考/头/外12345
尽管将提供完整的对象名称。如果外部ref还不存在，<远程对象名>将是全零对象名。如果要删除一个ref， <local ref>将作为(delete)提供，<local object name>将是全零对象名称。如果本地提交不是由可以扩展的名称(例如HEAD~，或者对象名称)指定的，那么它将按照最初给出的方式提供。

如果这个钩子以非零状态退出，git push将不推送任何东西而中止。关于拒绝推送的原因的信息可以通过写入标准错误发送给用户。

  • pre-rebase

这个钩子由git-rebase调用，可以用来防止分支被rebase。钩子可以带一个或两个参数调用。第一个参数是序列分叉的上游。第二个参数是正在重基的分支，在重基当前分支时不设置。

  • pre-receive

当git-receive-pack响应git push并更新其存储库中的引用时，会调用该钩子。就在开始更新远程存储库上的引用之前，调用预接收钩子。其退出状态决定了更新的成功或失败。

这个钩子执行一次接收操作。它不接受任何参数，但对于每个要更新的ref，它会在标准输入中接收一行格式如下:

SP <new-value> SP <ref-name> LF
其中<old-value>是存储在ref中的旧对象名称，<new-value>是存储在ref中的新对象名称，<ref-name>是ref的全名。创建新ref时，<old-value>是全零对象名称。

如果钩子以非零状态退出，则不会更新任何引用。如果钩子以0退出，更新钩子仍然可以阻止更新单个引用。

标准输出和标准错误输出都被转发到另一端的git send-pack，因此您可以简单地为用户回显消息。

git push命令行给出的push选项数——push-option=…可以从环境变量GIT_PUSH_OPTION_COUNT中读取，选项本身在GIT_PUSH_OPTION_0, GIT_PUSH_OPTION_1，…中找到，如果协商不使用推送选项阶段，则不会设置环境变量。如果客户端选择使用推送选项，但不传输任何选项，则计数变量将被设置为零，GIT_PUSH_OPTION_COUNT=0。

有关一些注意事项，请参阅gift -receive-pack中的“隔离环境”一节。

  • push-to-checkout

当git-receive-pack响应git push并更新其存储库中的引用时，以及当push尝试更新当前签出的分支并且receive.denyCurrentBranch配置变量设置为updateInstead时，该钩子被git-receive- receive-pack调用。默认情况下，如果工作树和远程存储库的索引与当前签出的提交有任何差异，则拒绝这样的推送;当工作树和索引都匹配当前提交时，它们将被更新以匹配新推送的分支尖端。此钩子将用于覆盖默认行为。

钩子接收当前分支的尖端将被更新的提交。它可以以非零状态退出以拒绝推送(当它这样做时，它不能修改索引或工作树)。或者，它可以对工作树和索引进行任何必要的更改，使它们在当前分支的尖端更新到新提交时达到所需的状态，并以零状态退出。

例如，钩子可以简单地运行git read-tree -u -m HEAD "$1"，以模拟git fetch与git push相反的方向运行，因为git read-tree -u -m的两树形式本质上与git switch或git checkout相同，它们在切换分支的同时保持工作树中的本地更改，而不会干扰分支之间的差异。

  • update

当git-receive-pack响应git push并更新其存储库中的引用时，会调用该钩子。就在更新远程存储库上的ref之前，调用更新钩子。它的退出状态决定了refupdate的成功或失败。

对于每个要更新的ref，钩子执行一次，并接受三个参数:

被更新的ref的名称，

旧的对象名称存储在ref，

以及要存储在ref中的新对象名称。

update钩子的零退出允许更新ref。以非零状态退出会阻止git receive-pack更新该ref。

这个钩子可以用来防止某些refs上的强制更新，通过确保对象名称是一个提交对象，是由旧对象名称命名的提交对象的后代。也就是说，执行“仅快进”策略。

它也可以用来记录新旧状态。然而，它并不知道分支的全部集合，因此在天真地使用时，它最终会为每个ref发送一封电子邮件。post-receive钩子更适合于此。

在限制用户只能通过网络访问git命令的环境中，这个钩子可以用来实现访问控制，而不依赖于文件系统所有权和组成员关系。请参阅git-shell[1]了解如何使用登录shell来限制用户只能访问git命令。

标准输出和标准错误输出都被转发到另一端的git send-pack，因此您可以简单地为用户回显消息。

默认的更新钩子，当启用时——并且带有钩子。允许unannotated配置选项unset或设置为false -防止未注释的标签被推送。

完整钩子说明，请参考官网链接

脚本逻辑

1、声明脚本运行环境

这里我们使用node进行编写，所以脚本运行环境应该声明为node

#!/usr/bin/env node
2、获取当前暂存更改的文件信息

我们可以使用git status来获取当前暂存更改的文件目录，但部分同学可能会出现获取到的文件名中文只显示字符串的情况：

image.png

  • 原因

在默认设置下，中文文件名在工作区状态输出，中文名不能正确显示，而是显示为八进制的字符编码。

  • 解决办法

将git 配置文件 core.quotepath项设置为false。
quotepath表示引用路径
加上–global表示全局配置

git bash 终端输入命令：

git config --global core.quotepath false

image.png

我们可以看到修改过的文件路径。

3、提取 git status 信息中的变动文件路径

上一步我们知道了可以使用git status命令来获取暂存更改的文件信息，但获取到的信息并不是直接得到变动的文件路径，我们需要从获取到的信息中的变动文件路径。

let commitFile = child_process.execSync(command).toString();
commitFile = commitFile.split("\n");
console.log("commitFile: ", commitFile);

image.png

这里前面的五行其实是固定的，我们只需要从第六行开始获取即可，文件路径与变更类型描述是通过:隔开，所以我们分割一下:，再将一些特殊字符去掉即可。

const child_process = require("child_process");
const trimReg = /(\ +)|([ ])|([\r\n]|(["]))/g;
const fileList = [];
for (let i = 5; i < commitFile.length; i++) {const name = commitFile[i].split(":")[1];if (!name) break;fileList.push(decodeURI(name.replace(trimReg, "")));
}
console.log("fileList: ", fileList);

image.png

4、判断文件中是否包含 debugger

通过readFileSync获取文件内容，判断文件内容是否包含debugger，包括的话将文件路径记录并将文件中的debugger全部删除，然后再将修改后的文件重新git add -文件路径提交即可。

const child_process = require("child_process");
const fs = require("fs");
const editFiles = [];
fileList.forEach((file) => {const txt = fs.readFileSync(file, "utf8");if (txt.includes("debugger")) {editFiles.push(file);fs.writeFileSync(file, txt.replace(/(debugger);?(\s*\n)*/g, ""));const commandAdd = "git add " + file;child_process.execSync(commandAdd).toString();}
});
console.log("editFiles: ", editFiles);
console.log("已清除提交文件中的 debugger");

完整代码

#!/usr/bin/env node
const child_process = require("child_process");
const fs = require("fs");
const command = "git status";
const trimReg = /(\ +)|([ ])|([\r\n]|(["]))/g;
let commitFile = child_process.execSync(command).toString();
commitFile = commitFile.split("\n");
const fileList = [];
for (let i = 5; i < commitFile.length; i++) {const name = commitFile[i].split(":")[1];if (!name) break;fileList.push(decodeURI(name.replace(trimReg, "")));
}
const editFiles = [];
fileList.forEach((file) => {const txt = fs.readFileSync(file, "utf8");if (txt.includes("debugger")) {editFiles.push(file);fs.writeFileSync(file, txt.replace(/(debugger);?(\s*\n)*/g, ""));const commandAdd = "git add " + file;child_process.execSync(commandAdd).toString();}
});
console.log("editFiles: ", editFiles);
console.log("已清除提交文件中的 debugger");
process.exit(0);

参考材料

https://zhuanlan.zhihu.com/p/521707440

https://git-scm.com/docs/githooks

公众号

关注公众号『前端也能这么有趣』，获取更多有趣内容。

说在后面

🎉 这里是 JYeontu，现在是一名前端工程师，有空会刷刷算法题，平时喜欢打羽毛球 🏸 ，平时也喜欢写些东西，既为自己记录 📋，也希望可以对大家有那么一丢丢的帮助，写的不好望多多谅解 🙇，写错的地方望指出，定会认真改进 😊，偶尔也会在自己的公众号『前端也能这么有趣』发一些比较有趣的文章，有兴趣的也可以关注下。在此谢谢大家的支持，我们下文再见 🙌。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.hqwc.cn/news/284807.html

如若内容造成侵权/违法违规/事实不符，请联系编程知识网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

C语言—每日选择题—Day53

C语言—每日选择题—Day53

指针相关博客 打响指针的第一枪&#xff1a;指针家族-CSDN博客 深入理解&#xff1a;指针变量的解引用 与 加法运算-CSDN博客 第一题 1. 有以下程序&#xff0c;输出的结果为&#xff08;&#xff09; #include <stdio.h> int main() {char a H;a (a > A &&…
阅读更多...
【03】GeoScene创建海图或者电子航道图数据

【03】GeoScene创建海图或者电子航道图数据

1 配置Nautical属性 1.1 管理长名称 长名称&#xff08;LNAM&#xff09;是一个必要的对象标识符&#xff0c;是生产机构&#xff08;AGEN&#xff09;、要素识别号码&#xff08;FIDN&#xff09;和要素识别子项&#xff08;FIDS&#xff09;组件的串联。这三个子组件用于数…
阅读更多...
MidJourney笔记（8）-ask和blend命令

MidJourney笔记（8）-ask和blend命令

经过前面的课程介绍，我相信大家对MidJourney有一定的认识，接下来就给大家介绍一下MidJourney的常用命令。 /ask 获取问题答案。 我一开始以为是随便问题都可以问，最后发现只能回答MidJourney相关的问题。 我们先试试一些日常生活问题： 今天天气如何？ 以为它不会识别中文，…
阅读更多...
蓝桥杯time模块常用操作

蓝桥杯time模块常用操作

#导入time模块import time #获取时间戳 start_time time.time () print ( "start_time ", start_time) time .sleep ( 3) end_time time.time () print ( "end_time ", end_time)#计算运行时间 print("运行时间 { :.0f } ".format(end_time …
阅读更多...
计算机毕业设计 基于SpringBoot的高校毕业与学位资格审核系统的设计与实现 Java实战项目 附源码+文档+视频讲解

计算机毕业设计 基于SpringBoot的高校毕业与学位资格审核系统的设计与实现 Java实战项目 附源码+文档+视频讲解

博主介绍&#xff1a;✌从事软件开发10年之余&#xff0c;专注于Java技术领域、Python人工智能及数据挖掘、小程序项目开发和Android项目开发等。CSDN、掘金、华为云、InfoQ、阿里云等平台优质作者✌ &#x1f345;文末获取源码联系&#x1f345; &#x1f447;&#x1f3fb; 精…
阅读更多...
Vue中英文翻译小结

Vue中英文翻译小结

背景&#xff1a;时局艰难&#xff0c;后端开发被强制写了vue&#xff0c;这不有个需求是中英文翻译&#xff0c;特此记录下&#xff0c;该怎么个翻译法子。 先引入全局的路由国际化文件&#xff0c;zh.js 和 en.js 1.关于插值表达Button里面 {{ $t(reinsop.common.back) }} …
阅读更多...
如何用Python向图像中加入噪声

如何用Python向图像中加入噪声

我们在做机器视觉项目的过程中&#xff0c;有的时候需要向图像中加入噪声。Pytorch本身不支持类似的功能&#xff0c;如果自己写的话&#xff0c;不但麻烦&#xff0c;而且容易出错。好在skimage支持这个功能。代码如下&#xff1a; import skimage import matplotlib.pyplot …
阅读更多...
匆匆前行 也适时驻足

匆匆前行 也适时驻足

冬日碎片 大家好&#xff0c;今天是小气吝啬的生信小博士 分享发生在身上的两件小事 2023年12月16日 与往常一样&#xff0c;周六早八例行组会&#xff0c;本想争分夺秒买完早饭直奔会议室&#xff0c;一个大姐挡住了我的去路&#xff1a; “小伙子&#xff0c;借你饭卡买个…
阅读更多...
P33鱼和熊掌可以兼得的机器学习-why deep

P33鱼和熊掌可以兼得的机器学习-why deep

Review: Why Hidden Layer? 在这里插入图片描述 ** 一个hidden 可以通过无数个 picewise linear 构成任意形状的曲线** 那么为什么还要 deep 呢 Why deep not Fat 同样参数量下&#xff0c;deep的模型表现优于 fat 的 Why we need deep? 使用deep&#xff0c;效率更高&…
阅读更多...
linux 操作系统(二)

linux 操作系统(二)

1、linux用户和权限 1.1、用户分类&#xff1a; 在linux中的用户可以分为两类&#xff0c;一类是root用户&#xff0c;root用户拥有linux操作系统的最大的权限&#xff0c;另外一类就是普通用户&#xff0c;相比于root用户&#xff0c;普通用户的权限受到一定的限制&#xff0…
阅读更多...
【Matlab】如何可视化多项式函数（附完整MATLAB代码）

【Matlab】如何可视化多项式函数（附完整MATLAB代码）

可视化多项式函数 前言多项式函数MATLAB 对理解多项式函数的帮助 正文思考步骤 代码实现及图像显示对于一元多项式函数对于多元多项式函数 前言 多项式函数 多项式函数是数学中常见的一类函数&#xff0c;它的一般形式可以表示为&#xff1a; [ f ( x ) a n x n a n − 1 x…
阅读更多...
【Redis】五、Redis持久化、RDB和AOF

【Redis】五、Redis持久化、RDB和AOF

文章目录 Redis持久化一、RDB&#xff08;Redis DataBase&#xff09;触发机制如何恢复rdb文件 二、AOF&#xff08;Append Only File&#xff09;三、扩展 Redis持久化 面试和工作&#xff0c;持久化都是重点&#xff01; Redis 是内存数据库&#xff0c;如果不将内存中的数据…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023