Unity之VS脚本自动添加头部注释Package包开发

内容将会持续更新，有错误的地方欢迎指正，谢谢!
 

Unity之VS脚本自动添加头部注释Package包开发      

---

TechX 坚持将创新的科技带给世界！ 拥有更好的学习体验 —— 不断努力，不断进步，不断探索

TechX —— 心探索、心进取！ 助力快速掌握 头部注释 自动添加 为初学者节省宝贵的学习时间，避免困惑！

前言：

  在 Unity 开发中，我们常常需要在创建新脚本时添加一些标准化的头注释，例如作者姓名、创建日期等。手动添加这些信息既麻烦又容易出错。本文将介绍在创建C# Scripts时如何自动添加脚本注释头，并提供一个完整的示例代码。

TechX 教程效果：

---

---

一、初始化自动添加头部注释Package包ScriptHeadComments

从零开始创建Unity自定义包Package：一步一步实现您的功能

1、创建Package包

在工程文件的Packages文件夹下创建一个文件夹作为包的根目录，文件夹的名称为com.fxb.scriptheadcomments_v1.0.0，文件夹结构如下图所示：

• Editor文件夹：

  放置Unity编辑器脚本。

• Resources文件夹：

  包含这个包用到的一些资源文件。

• CHANGELOG.md日志记录文件：

  文件中记录新增功能、改进和错误修复等信息。

• package.json包清单文件：

  包含包的元信息，如名称、版本、依赖项等。

2、编译包清单文件package.json

打开package.json文件，填入以下包清单信息。

{
   
  "name": "com.fxb.scriptheadcomments",
  "displayName": "ScriptHeadComments",
  "version": "1.0.0",
  "unity": "2021.3",
  "description": "Displays the script header information",
  "keywords": [
    "scripthead",
    "script",
    "head",
    "comments"
  ],
  "unityRelease": "38f1"
}

等待Unity编译完成，可以查看到该包已经导入到工程中。

3、添加Assembly Definition程序集

在Editor文件夹中添加一个程序集，通过Create/Assembly Definition创建com.fxb.ScriptHeadComments.Editor程序集

创建完成后，设置Platforms平台为Edito。

---

二、修改C# ScriptTemplate文件

1、查找Unity默认C# 脚本模板81-C# Script-NewBehaviourScript.cs.txt

在Unity中新建C# Script时，Unity使用的是编辑器中默认的C#脚本模板。我们可以直接在该模板文件中添加自定义注释。

我安装的Unity版本是Unity 2021.3.38f1，脚本模板文件在Unity 2021.3.38f1\Editor\Data\Resources\ScriptTemplates文件夹下

其中81-C# Script-NewBehaviourScript.cs.txt为C# 脚本模板。

2、编辑脚本模板81-C# Script-NewBehaviourScript.cs.txt

使用记事本打开81-C# Script-NewBehaviourScript.cs.txt文件，并在头部添加注释信息

• 公司：Company
• 项目：Project
• 文件：FileName
• 作者：Author
• 日期：Date
• 功能：Function

/*************************************************************************
 *  Copyright © 2023-2030 Administrator. All rights reserved.
 *------------------------------------------------------------------------
 *  公司：DefaultCompany
 *  项目：Unity
 *  文件：NewBehaviourScript.cs
 *  作者：Administrator
 *  日期：2024/7/4 20:11:28
 *  功能：Nothing
*************************************************************************/

using System.Collections;
using System.Collections.Generic;
using UnityEngine;

    #ROOTNAMESPACEBEGIN#
public class #SCRIPTNAME# : MonoBehaviour
{
   
    // Start is called before the first frame update
    void Start()
    {
   
        #NOTRIM#