AdonisJS 官方文档虽然详尽地涵盖了 VSCode 的调试指南，却没有关于 Jetbrains 系列产品的相应调试说明。
了解 Jetbrains 产品的调试配置以后，要配置 WebStorm 来调试 AdonisJS 其实是非常容易的。

步骤一： 创建或编辑运行/调试配置

用 WebStorm 打开你的 AdonisJS 项目后，点击调试工具栏上的下拉菜单，点击编辑配置。

在弹出的窗口中，点击右上角的“+”按钮，选择“Node.js”作为调试类型，然后（如下图）输入配置信息。

• 【名称】输入调试配置的名称，便于识别。
• 【Node 解释器】选择项目所使用的 Node 解释器。
• 【工作目录】为项目根目录。
• 【应用程序形参】输入 ace serve --hmr。

步骤二： 启动调试

点击调试工具栏的下拉菜单，选择刚加的调试配置（如下图）

然后再点击调试按钮（那只小虫子，如下图），或者按 Shift + F9 快捷键，就可以启动调试了。

启动调试后，只要给程序执行经过位置加上断点，程序执行到断点处就会暂停下来，这样我们就可以查看程序当前执行所在位置的各个变量的值了。

具体调试操作就不多说了，你自己能搞定。

在 Linux 上使用 Certbot 为 Nginx 部署 SSL 证书是一个很简单的过程，只需要执行几个命令就可以。
以下演示在 Ubuntu/Debian 上通过 Certbot 为 Nginx 服务器获取并安装SSL证书，其他 Linux 系统安装命令类似。

安装 Nginx

首先，确保你的 Ubuntu/Debian 服务器上已经安装了 Nginx。如果还没有安装，可以使用以下命令进行安装：

1
2

sudo apt update
sudo apt install nginx

部署 Nginx http 站点

先部署好 Nginx http 站点，certbot-nginx 插件将自动往 Nginx 配置中加入 SSL 部署配置。

安装 Certbot 及其 Nginx 插件

1
2

sudo apt install certbot python3-certbot-nginx
#sudo apt install certbot python3-certbot-apache # Apache 可使用此命令

获取并安装SSL证书

安装 Certbot 和 Nginx 都安装后，你可以使用 Certbot 的 Nginx 插件来自动为你的网站获取并安装SSL证书。运行以下命令：

1
2

sudo certbot --nginx -d yourdomain.com -d www.yourdomain.com
#sudo certbot --apache -d yourdomain.com -d www.yourdomain.com # Apache 可使用此命令

记得将 yourdomain.com 替换为你的实际域名。

执行此命令， Certbot 将执行以下操作：

• 自动检测你的 Nginx 配置。
• 提示你验证对域名的所有权（通过请求域名 HTTP 站点）。
• 获取 Let’s Encrypt 的 SSL 证书。
• 自动修改 Nginx 配置文件，以使用新的 SSL 证书和密钥。
• 重新加载 Nginx 以应用更改。
• 加入定时更新证书的系统任务。

fnm（Fast and Minimal Node Manager）是一个相对较新的 Node.js 版本管理工具。它的设计目标是提供一个快速且轻量级的解决方案，用于安装、管理和切换不同版本的 Node.js。
与 nvm（Node Version Manager）相比，fnm 强调更少的依赖和更快的启动速度，并且支持跨平台，Windows/Linux/Mac 都能用。

1、安装 fnm

全平台安装

如果你的电脑安装了 rust 环境，可直接用 cargo 安装

1

cargo install fnm

Linux/Mac 下安装

使用脚本安装

1

curl -fsSL https://fnm.vercel.app/install | bash

或者使用 brew 安装

1

brew install fnm

Windows 下安装

1

winget install Schniz.fnm

2、激活 fnm

Linux/Mac

1
2

eval "$(fnm env --use-on-cd --shell bash)"
source ~/.bashrc

Windows

将以下代码加入 PowerShell 的配置文件。

1

fnm env --use-on-cd --shell powershell | Out-String | Invoke-Expression

powershell 配置文件不同版本的windows 可能位置不一样，
可能位于 ~\.config\powershell\Microsoft.PowerShell_profile.ps1，
也可能位于 ~\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1，
用 notepad $profile 或 （如果安装了VSCode）code $profile 命令即可打开编辑。

3、使用

1
2
3
4
5
6
7
8

fnm list # 查看本地已安装 Node.js 版本
fnm list-remote # 查看全部可安装的版本
fnm install 23 # 安装 Node.js v23 最新的子版本
fnm install --lts # 安装当前 lts 版
fnm use 23 # 使用 v23.x ，如 v23.1.0，仅当前终端切换，其它终端窗口不受影响
fnm use system # 使用系统的 Node.js（不是通过 fnm 安装的）
fnm default 23 # 把默认 Node.js 版本切换到 v23.x，所有终端默认的 Node.js 将使用该版本
fnm default system # 把默认 Node.js 切换到系统安装的程序

注

fnm 安装的 Node.js 程序位于 Windows 的 ~\AppData\Roaming\fnm\node-versions，Linux/Mac 的 ~/.local/share/fnm/node-versions
Node.js 对于一机多版本的需求没 Python 那么强，一般情况下安装当前 LTS 版就够用了。

1、修改 gradle-wrapper

修改 gradle-wrapper.properties 文件的 distributionUrl 参数

1

distributionUrl=https\://services.gradle.org/distributions/gradle-8.0.2-bin.zip

2、更换仓库

项目根目录下的 build.gradle 文件的 buildscript.repositories 加入：

1
2

maven { url 'https://maven.aliyun.com/repository/google' } // Google Maven镜像
maven { url 'https://maven.aliyun.com/repository/public' } // Maven Central 镜像

3、执行 sync

新的 Vue 项目使用了 Tailwind + SCSS，突然发现修改 app.scss 文件的时候，热更新需要 14s+ 才能加载完成。和之前项目唯一不同的是scss的 @import 换成了 @use，这地方应该没问题，sass 团队不可能会犯这么低级的错误。

突然想起，前两天把 128k 的地区数据 regions.js 放 src 目录下了，很有可能是这个引起的。试着把该文件移出 src 目录，还真是。解决：把该文件改为 json 格式，放到 assets 目录。

默认的 tailwind 配置会扫描源码目录下的 vue,js,ts,jsx,tsx 文件，js 文件过大太复杂的时候就会引起问题了。我项目只有 vue 文件需要taiwnid 扫描，把其他后缀去掉，热加载速度明显快很多。配置如下：

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

// tailwind.config.js
/** @type {import('tailwindcss').Config} */
export default {
  content: [
    "./index.html",
    // "./src/**/*.{vue,js,ts,jsx,tsx}",
    "./src/**/*.vue",
  ],
  theme: {
    extend: {},
  },
  plugins: [],
}

PhpStorm / WebStorm 新建项目中，有时候 TailwindCSS 自动提示没有出来。
原因如下：

• 1、只支用 npm，你项目可能用 pnpm 了
• 2、IDE 设置的 Node 解释器可能跟你项目使用的解释器不对应。

打开 “设置 > 语言和框架 > Node.js”，选择“Node 解释器”为当前项目使用的 node 解释器。有时候项目在 wsl 中开发，默认是本地的 node，会导致问题。

Laravel 9 之前模型属性访问器、修改器

通过 setFooBarAttribute($value)、getFooBarAttribute() 方法来定义和访问自定义动态 fooBar 属性。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    /**
     * 设置用户的名字
     */
    public function setFirstNameAttribute($value)
    {
        $this->attributes['first_name'] = strtolower($value);
    }

    /**
     * 获取用户的全名
     */
    public function getFullNameAttribute()
    {
        return "{$this->first_name} {$this->last_name}";
    }
}

Laravel 9 及之后版本的模型属性访问器、修改器

通过返回值类型为 Attribute 类来定义和访问自定义动态属性。

方案1：一个表设计一个多语言内容关联表

表解构

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

- product_categories 
  - id
- product_categorie_l10ns
  - category_id # 关联 product_categories.id
  - locale
  - name
- products
  - id
  - category_id # 关联 product_categories.id
- product_l10ns
  - product_id  # 关联 products.id
  - locale
  - title
  - desciption
  - detail

Alpine Linux 占用空间少，可定制性高，除了很适合跑 docker 容器外，也很适合跑在 wsl 中。

下载 WSL 版 Alpine Linux

打开链接 https://github.com/yuk7/AlpineWSL/releases 找到系统对应的 Alpine 版本，如 Alpine.zip，解压到你想要存放的位置，点击 Alpine.exe 文件即可安装好。

安装好后，将在 Alpine.exe 所在文件夹中创建 ext4.vhdx 虚拟磁盘文件，作为 AlpineLinux 的磁盘。控制台执行命令 wsl -l -v，将看到新安装的 wsl 发行版 Alpine。

启动 Alpine

命令 wsl -d Alpine

使用国内镜像源

打开源配置：

1

vi /etc/apk/repositories

注释掉默认源：

1
2

#https://dl-cdn.alpinelinux.org/alpine/v3.18/main
#https://dl-cdn.alpinelinux.org/alpine/v3.18/community

加入阿里源配置：

1
2

http://mirrors.aliyun.com/alpine/v3.19/main
http://mirrors.aliyun.com/alpine/v3.19/community

或 加入腾讯源配置：

1
2

https://mirrors.cloud.tencent.com/alpine/v3.19/main
https://mirrors.cloud.tencent.com/alpine/v3.19/community

执行更新命令更新源数据和已安装的apk包：

1

apk -U upgrade

部署PHP 8.2

1
2
3
4
5

apk add php82 php82-pear php82-dev php82-pdo_mysql \
    php82-iconv php82-mbstring php82-tokenizer \
    php82-session php82-dom curl php82-curl \
    php82-xmlwriter php82-fileinfo php82-posix \
    redis php82-pecl-redis

把 82 改为 81 或 83 即为安装 php-8.1 或 php-8.3
如果出现错误，apk add gcc，``

如果安装 php-8.1 出现一下错误：

1
2
3
4
5
6
7

ERROR: unable to select packages:
  php81-pecl-msgpack-2.2.0-r0:
    conflicts: php82-pecl-msgpack-2.2.0-r0[php-msgpack=2.2.0-r0]
    satisfies: php81-pecl-redis-6.0.2-r0[php81-pecl-msgpack]
  php82-pecl-msgpack-2.2.0-r0:
    conflicts: php81-pecl-msgpack-2.2.0-r0[php-msgpack=2.2.0-r0]
    satisfies: php82-pecl-redis-6.0.2-r0[php82-pecl-msgpack]

安装脚本中去掉 php82-pecl-redis再执行。

php8 版本切换

如果同时安装多个 php 版本，可通过脚本来更换默认版本php。

创建脚本 vi /usr/php-switch，输入以下内容：

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

#!/bin/bash
cd /usr/bin

rm -f php php-config phpize pecl phar phar.phar

v=${1:-82}

ln -s php${v} php
ln -s php-config${v} php-config
ln -s phpize${v} phpize
ln -s pecl${v} pecl
ln -s phar.phar${v} phar
ln -s phar.phar${v} phar.phar

echo '已切换到php'$v

设置权限为可执行 chmod +x /usr/php-switch。

1
2
3
4
5
6
7
8

# 默认切换到php 8.2
php-switch

# 切换到php 8.1
php-switch 81

# 切换到php 8.3
php-switch 83

安装 Nodejs

1

apk add icu-data-full nodejs npm

少儿学习编程有很多意义，主要体现在以下几个方面：

1、培养编程思维能力

编程思维（也叫计算思维）是一种解决问题的思维方式，它强调的是把问题分解成更小的部分，然后逐个解决。编程思维的核心是抽象、模块化和自动化。在学习编程的过程中，孩子可以练习如何运用编程思维来解决问题，孩子需要理解问题、拆解问题、抽象问题、设计解决方案、实施方案等一系列步骤。这种思维方式强调从问题到解决方案的转化过程，培养了孩子的逻辑思维和分析问题的能力。

这可以帮助孩子提高解决问题的能力，并为未来的学习和工作打下基础。