PHPDoc、JSDoc、Vue JSDoc相关的语法，持续记录

/**
 * 计算两个数的和
 * @param int $a 第一个数字
 * @param int $b 第二个数字
 * @return int 两数之和
 */
function add($a, $b){
    return $a + $b;
}

/**
 * 计算平均值
 * @param array $numbers 数字数组
 * @return float 平均数
 */
function average($numbers){
    return array_sum($numbers)/count($numbers);
}

/**
 * 用户姓名
 *
 * @var string
 */
public $name;

/**
* 根据用户名查找用户信息
* param string $username 用户名.
* return string 用户信息.
* throws InvalidUsernameException 如果用户名无效，则抛出异常.
*/
function getUserInfoByUsername($username) {
   if (/* 检查用户名是否有效*/) {
      // 如果用户名无效，则抛出异常.
      throw new InvalidUsernameException('Invalid username provided '.$username);
   }
 
   // 返回用户信息.
   return $userInfo;
}

/**
 * 弃用的方法
 * @deprecated 该方法已被弃用，请改用 newMethod 函数。
 */
function OldMethod(){
    // 该方法已被弃用
}

/**
 * 计算两个数字之和。
 * @param {number} a - 第一个数字
 * @param {number} b - 第二个数字
 * @returns {number} 两个数字之和
 */
function add(a, b) {
    return a + b;
}

/**
 * 计算数组中所有元素之和。
 *
 * @param {Array<number>} arr - 数字数组
 * @returns {number} 数组中所有元素之和
 */
function sum(arr) {
    return arr.reduce((acc, cur) => acc + cur);
}

/**
 * 用户信息对象。
 *
 * @typedef {Object} UserInfo
 *
 * @property {string} name 用户姓名
 * @property {string} email 用户邮箱地址
 */

/**
* 获取用户信息.
*
* @param userId 用户ID.
*
* returns {UserInfo[]} 所有匹配用户的列表.
*/
function getUserInfo(userId) {
   // 查询并返回用户信息...
}

// TypeScript
let name: string = 'Amy';

// JSDoc
/** @type {string} */
let name = 'Amy';

/**
 * Button 组件
 *
 * @prop {Boolean} disabled 是否禁用
 * @prop {String} type button 类型（按钮类型），可选值为 `'primary'`, `'success'`, `'warning'`, `'danger'`, 或者不设置.
 */

/**
 * Table 组件.
 *
 * @event row-clicked({row: Object}) 表格行被点击时触发.
 */

/**
 * Alert 组件.
 *
 * @slot title 标题
 *   Alert 标题内容.
 *
 * @slot content 内容
 *   Alert 描述信息，支持 HTML 填入.
 */