Mac - 标签 - 菠菜眾長

解决 SourceTree 提交时候 husky 命令失败问题

Lruihao — Mon, 12 Jun 2023 10:58:44 +0800

问题描述

在使用 SourceTree 提交代码的时候，会出现 husky 命令失败的问题（通过命令行提交代码没有问题），如下图所示：

看错误，是一个 catch 参数的问题，在新版本的 Node 中，catch 参数是可以省略的，但是在旧版本中，catch 参数是必须的。

由于使用了 nvm 管理 Node 版本，项目中的 Node 是正常的，但是 SourceTree 使用的是系统的 Node，所以会出现这个问题。

解决方案

知道了问题的原因，解决起来就很简单了，只需要将 SourceTree husky hook 阶段的 Node 版本切换到项目中的 Node 版本即可。

配置 .huskyrc 文件，内容如下：

1

echo "export PATH=\"$(dirname $(which node)):\$PATH\"" > ~/.huskyrc

如果你使用了 zsh 和 nvm, 建议在 $ZSH_CUSTOM 目录下添加一个自定义 zsh 脚本。这个脚本会在你进入包含了 .nvmrc 文件目录中自动切换 node 版本，切换版本后修正 ~/.huskyrc 的 path 内容。

1

vim $ZSH_CUSTOM/nvm_custom.zsh

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33


# https://github.com/nvm-sh/nvm#manual-install
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion

# https://github.com/nvm-sh/nvm#deeper-shell-integration
autoload -U add-zsh-hook
load-nvmrc() {
  local node_version="$(nvm version)"
  local nvmrc_path="$(nvm_find_nvmrc)"

  if [ -n "$nvmrc_path" ]; then
    local nvmrc_node_version=$(nvm version "$(cat "${nvmrc_path}")")

    if [ "$nvmrc_node_version" = "N/A" ]; then
      nvm install
    elif [ "$nvmrc_node_version" != "$node_version" ]; then
      nvm use
    fi
  elif [ "$node_version" != "$(nvm version default)" ]; then
    echo "Reverting to nvm default version"
    nvm use default
  fi

  # fix husky hook
  # ref: https://github.com/typicode/husky/issues/390#issuecomment-762213421
  echo "export PATH=\"$(dirname $(which node)):\$PATH\"" > ~/.huskyrc
}
add-zsh-hook chpwd load-nvmrc
load-nvmrc

# https://github.com/nvm-sh/nvm#use-a-mirror-of-node-binaries
export NVM_NODEJS_ORG_MIRROR=https://mirrors.ustc.edu.cn/node/

参考

安装 Homebrew 后导致系统中原有的 npm 和 npx 失效

Lruihao — Thu, 15 Dec 2022 15:33:30 +0800

问题

前面一段时间，安装了 Homebrew, 但是今天切换 node 版本到 system version (8.10.0) 后，发现虽然 node 版本切换成功，但是 node 版本对应的 npm 和 npx 版本不相符，下面记录一下问题排查过程。

罪魁祸首

首先定位到这次问题的根本原因是安装 Homebrew 导致的，这点可以很快也很明确地定位到，因为以前安装 Homebrew 也遇到了这个问题，但是当时的做法是卸载 Homebrew 避免冲突。

Why

分析为啥会冲突，Homebrew 安装的工程中也会默认一部分依赖的二进制文件，npm 和 npx 也在其中，所以这导致了 Homebrew 的安装 npm 和 npx 覆盖了系统中 node 的 npm 和 npx 进而导致 node 和 npm 版本不一致，无法使用 npm 启动项目。

Where

找一下目前 npm 和 npx 的二进制文件在哪。

1
2
3
4


nvm use system
node -v           # 8.10.0
which npm         # /opt/homebrew/bin/npm
which npx         # /opt/homebrew/bin/npx

How

很明显前面的猜测是对的，那就打开这个目录看看：

1

open /opt/homebrew/bin

找到 npm 和 npx，把他们重命名为 npm-brew 和 npx-brew, 这样通过别名也保留 Homebrew 的 npm 和 npx.

修改完后，重启终端，再看看 npm 和 npx 是否生效：

1
2
3
4
5
6


nvm use system
node -v           # 8.10.0
which npm         # /usr/local/bin/npm
which npx         # /usr/local/bin/npx
npm -v
npx -v

一切正常了，可以用 npm 继续启动原来的项目了。

linux 文件权限

Lruihao — Sat, 30 Jul 2022 17:15:44 +0800

记录 linux 系统下文件权限相关的内容，Mac OS 下类似。

查看文件权限

查看 linux 系统下的文件权限，可以使用 ll 命令或者 ls 命令带 -l（长列表选项）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


➜  ~ ll
total 160
drwx------@  8 liruihao  staff   256B Jul  5 14:47 Applications
drwx------@ 10 liruihao  staff   320B Jul 27 11:31 Desktop
drwx------+  7 liruihao  staff   224B Jun 17 15:01 Documents
drwx------@ 22 liruihao  staff   704B Jul 29 16:35 Downloads
drwx------@ 94 liruihao  staff   2.9K Jul 23 19:02 Library
drwx------   4 liruihao  staff   128B Nov 13  2021 Movies
drwx------+  6 liruihao  staff   192B Nov 18  2021 Music
drwx------+  9 liruihao  staff   288B Apr 26 10:25 Pictures
drwxr-xr-x+  5 liruihao  staff   160B Nov 14  2021 Public
drwxr-xr-x   5 liruihao  staff   160B Jul 29 17:48 file-share
drwxr-xr-x   3 liruihao  staff    96B Jul 26 17:17 node_modules
-rw-r--r--   1 liruihao  staff    27B Jun 24 13:47 package-lock.json
drwxr-xr-x  20 liruihao  staff   640B Jul 29 22:20 workspace
-rw-r--r--   1 liruihao  staff    86B Jul 26 17:17 yarn.lock

文件列表信息分为：文件类型、权限、链接数、所属用户、所属用户组、文件大小、最后修改时间、文件名。

文件类型

linux 一共有 7 种文件类型，分别如下：

-: 普通文件
d: 目录文件
l: 链接文件
b: 块设备文件
p: 管道文件
c: 字符设备文件
s: 套接口文件/数据接口文件

后四种是特殊文件

文件权限对应关系

权限	含义	对应数字
r	读权限	4
w	写权限	2
x	执行权限	1

读、写、运行三项权限用数字表示就是 r=4,w=2,x=1。所以，-rw-r--r-- 用数字表示成 644。

权限字段 -rwxrwxrwx 的内容总共会有 10 个 -，第一个表示文件类型，如该文件是文件 (-表示），文件夹 (d 表示）, 连接文件 (l 表示），后面 9 个按照每三位为一组分。

1

drwxr-xr-x   5 liruihao  staff   160B Jul 29 17:48 file-share

d: 代表文件夹

rwx: 代表文件所有者 (u 表示）权限，这里是 liruihao，liruihao 对该文件拥有读写执行权限。

r-x: 代表所属（g 表示）的权限，这里同组用户拥有对该文件读和执行的权限。

r-x: 代表其他用户（o 表示）的权限，这里和上面权限一样。

Mac 上的开发配置总结

Lruihao — Fri, 29 Jul 2022 20:22:44 +0800

记录一下使用 Mac 作为生产工具开发的一些基本配置和经验。

配置文件

Mac 上有很多配置文件都可以用来保存环境变量等配置，根据自己的理解记录了四个文件的用途：

1
2
3
4
5


# etc/profile        系统配置文件
# etc/.bash_profile  系统环境变量配置
# ~/.bash_profile    个人环境变量配置
# ~/.zshrc           zsh 的配置文件
# $ZSH_CUSTOM/*.zsh  自定义 zsh 脚本，在 zsh 启动时会自动执行

编辑最多的应该是 ~/.bash_profile 和 ~/.zshrc, 基本上建议所有的个人配置都放在 ~/.bash_profile 中，然后在 ~/.zshrc 最后执行 source ~/.bash_profile, 这样也方便将自己的个人环境变量配置备份。

常用命令

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# 安装/卸载 homebrew install.sh/uninstall.sh
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 注意：安装 Homebrew 会下载 node, 请做好 node 环境被破坏的准备

# 显示隐藏文件 true/false or cmd+shift+.
defaults write com.apple.finder AppleShowAllFiles -boolean true ; killall Finder

# 释放端口
lsof -i:$your_port  # 1. 查看使用端口进程
kill -9 $your_PID   # 2. 释放进程

Node

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45


# 设置阿里镜像
npm config set registry=https://registry.npmmirror.com
# npm config set registry https://registry.npmjs.org

# GitHub 仓库下载地址前缀镜像
# disturl=https://registry.npmmirror.com/-/binary/

# 全局安装的依赖
npm install -g npm@8.13.1
npm install -g cnpm
npm install -g @vue/cli
npm install -g nvm
npm install -g nrm
npm install -g yarn
npm install -g yrm

# npm 参数
--ignore-scripts  # 忽略脚本错误
--force  # 会无视冲突，并强制获取远端 npm 库资源，即使本地有资源也会覆盖掉
--legacy-peer-deps  # 安装时忽略所有 peerDependencies，忽视依赖冲突，采用 npm 版本 4 到版本 6 的样式去安装依赖，已有的依赖不会覆盖

# 清除缓存
npm cache clean --force
rm -rf node_modules
rm -rf package-lock.json
npm install

# nvm
nvm alias default [node_version]  # 设置默认版本

# 检查过时依赖
npm outdated

# 安全更新
npm update

# ncu 更新检查工具
# https://blog.51cto.com/u_13028258/5115637?b=totalstatistic
npm install -g npm-check-updates
## 检查
ncu
ncu vue
## 更新
ncu -u
ncu -u vue

electron 相关配置

1
2
3
4


# 设置 electron 镜像仓库
# https://registry.npmmirror.com/-/binary/electron
# 13.1.7 版本 下载链接可能会拼错导致 404，要设置成 https://registry.npmmirror.com/-/binary/electron/v
npm config set electron_mirror=https://npmmirror.com/mirrors/electron/

SourceTree

Custom actions

Script target: /bin/bash
Parameters: /Users/liruihao/workspace/.shell/sync_tags.sh

技巧

根据不同的 shell 程序选择不同的文件后缀名，并给文件增加可执行权限：

zsh: .zsh
bash: .sh

1
2
3
4
5
6


#! /bin/bash
# 同步远程仓库标签分支脚本
git tag -l | xargs git tag -d
# git fetch origin --prune
# git fetch origin --tags
git fetch origin --prune --prune-tags

1
2
3


#! /bin/bash
# 同步所有子模组
git submodule update --remote --merge

1
2
3
4


#! /bin/zsh
# ssh 配置但无法连接时
ssh-agent -s
ssh-add ~/.ssh/Lruihao-Github  # 私钥路径

技巧

开机启动时系统会去自动读取 id_rsa 的私钥来启动 SSH 链接，若不是默认命令就会失败需要手动执行上诉命令启动，可添加到开机自启动。

SourceTree 相关文章

解决 SourceTree 提交时候 husky 命令失败问题

Terminal

Terminal: 系统自带
Shell: zsh
美化: ohmyzsh

修改启动语

1

vim $PREFIX/etc/motd

sublime-text 3

1
2
3
4
5
6
7


# Terminal 启用 sublime 别名 subl
## 1.设置软链（推荐）
sudo ln -s "/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl" /usr/local/bin/subl
## 2.设置别名
vim ~/.bash_profile
alias subl="'/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl'"
source ~/.bash_profile # 每打开一个命令窗口，需要先让命令生效

开机自启动

系统偏好设置 -> 用户与群组 -> 登录项 -> 增删可执行文件 (需配置默认启动软件)
将 shell 命令添加到 /System/Library/StartupItems/ 或 /Library/StartupItems/ 文件夹（测试无效）

备份

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67


# -------------------------------------
# This configuration is for Lruihao.
# https://lruihao.cn/posts/config4mac/
# -------------------------------------

export LC_ALL=en_US.UTF-8
export LANG=en_US.UTF-8

# workspace
export WORKSPACE="$HOME/workspace"

# alias
alias subl="'/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl'"
alias mysql=/usr/local/mysql/bin/mysql
alias mysqladmin=/usr/local/mysql/bin/mysqladmin
alias incr="source $WORKSPACE/.shell/incr*.zsh"
alias typora="open -a typora"

# maven
export M2_HOME=$HOME/Applications/apache-maven-3.8.5
export PATH=$PATH:$M2_HOME/bin

# jenv
export PATH="$HOME/.jenv/bin:$PATH"
eval "$(jenv init -)"

# java
export JAVA_8_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_321.jdk/Contents/Home
export JAVA_17_HOME=/Library/Java/JavaVirtualMachines/jdk-17.0.2.jdk/Contents/Home
export JAVA_HOME=$JAVA_8_HOME  # 设置一个中间变量，为了方便多个 JDK 版本时更换 JAVA_HOME
export PATH=$JAVA_HOME/bin:$PATH:.  # 冒号前代表 JDK 目录下的 bin 目录，冒号后代表当前目录
export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar

# jmeter
export JMETER_HOME=$HOME/jmeter/apache-jmeter-5.4.1
export PATH=$JAVA_HOME/bin:$PATH:.:$JMETER_HOME/bin:$PATH
export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar:$JMETER_HOME/lib/ext/ApacheJMeter_core.jar:$JMETER_HOME/lib/jorphan.jar:$JMETER_HOME/lib/logkit-2.0.jar

# platform-tools of Android SDK
export PATH=$PATH:$HOME/Applications/platform-tools

# Electron-Mac app development
export CSC_LINK=$WORKSPACE/mac_app_dev/Mac.p12
export CSC_KEY_PASSWORD=xxxxxxxxx

# yarn
export PATH="$HOME/.yarn/bin:$HOME/.config/yarn/global/node_modules/.bin:$PATH"

# zsh custom plugin
# https://mimosa-pudica.net/zsh-incremental.html
# source $WORKSPACE/.shell/incr*.zsh

# Qcloud secret key-value
export SECRET_ID=""
export SECRET_KEY=""

# golang
export GOROOT=/usr/local/go
export GOBIN=$GOROOT/bin
export PATH=$PATH:$GOBIN
export GOPATH=$HOME/go
export GOPROXY=https://goproxy.cn
# Go work bin
export PATH=$PATH:$GOPATH/bin

# sass_embedded
export PATH=$PATH:$HOME/Applications/sass_embedded

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33


# https://github.com/nvm-sh/nvm#manual-install
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion

# https://github.com/nvm-sh/nvm#deeper-shell-integration
autoload -U add-zsh-hook
load-nvmrc() {
  local node_version="$(nvm version)"
  local nvmrc_path="$(nvm_find_nvmrc)"

  if [ -n "$nvmrc_path" ]; then
    local nvmrc_node_version=$(nvm version "$(cat "${nvmrc_path}")")

    if [ "$nvmrc_node_version" = "N/A" ]; then
      nvm install
    elif [ "$nvmrc_node_version" != "$node_version" ]; then
      nvm use
    fi
  elif [ "$node_version" != "$(nvm version default)" ]; then
    echo "Reverting to nvm default version"
    nvm use default
  fi

  # fix husky hook
  # ref: https://github.com/typicode/husky/issues/390#issuecomment-762213421
  echo "export PATH=\"$(dirname $(which node)):\$PATH\"" > ~/.huskyrc
}
add-zsh-hook chpwd load-nvmrc
load-nvmrc

# https://github.com/nvm-sh/nvm#use-a-mirror-of-node-binaries
export NVM_NODEJS_ORG_MIRROR=https://mirrors.ustc.edu.cn/node/

先添加一些基础配置 basic.vim

1
2
3
4
5
6
7


"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
" => Custom config for Lruihao
"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
" Enable mouse
set mouse=a
" Enable line-number
set number