HTML注释中不能放置作者联系方式，因其仅为前端标记、不被搜索引擎或工具识别；标准做法是使用<meta name="author">、结构化JSON-LD数据或项目级文档（如README.md）来声明联系信息。
HTML 注释里不能放作者联系方式
HTML 注释（<!-- ... -->）是纯前端标记，不参与任何标准文档元数据规范，也不被搜索引擎、构建工具或协作平台识别为“作者信息”。把邮箱、微信、GitHub 链接塞进注释里，既不符合语义，也起不到法律或协作层面的标识作用——它只是浏览器开发者工具里一眼扫过的几行字。
真正有效的作者/联系信息该写在哪
标准做法是通过 <meta> 标签在 <head> 中声明，但注意：HTML5 不再定义 author 以外的联系类 name 值。可用方案如下：
-
name="author"：仅限真实作者姓名，不支持邮箱或链接（例：<meta name="author" content="张三">） -
name="generator"：适合标注技术栈（如content="Vue 3 + Vite"），间接体现维护者能力边界 - 结构化数据用
<script type="application/ld+json">：可完整描述Person对象，含sameAs指向 GitHub / Mastodon 等公开主页（搜索引擎可索引） - 项目级信息统一放在
README.md或CONTRIBUTING.md：这是开源协作的事实标准，比 HTML 注释可靠十倍
如果非要加注释，怎么写才不翻车
有些团队会用注释记录内部维护人，但必须遵守两个底线：不暴露敏感信息、不误导协作预期。常见错误包括写 <!-- 联系李四：lisi@company.com --> （邮箱可能被爬虫收集）或 <!-- 最后更新：2023-01-01 --> （时间未自动化，极易过期）。
安全写法示例：
立即学习“前端免费学习笔记（深入）”；
Conventional Git
下载
Conventional Commits v1.0.0 分支、工作树命名及提交信息规范，适用于 GitHub 与 GitLab 项目，用于创建分支和命名工作树等场景。
<!-- @maintainer: frontend-team @source: git@gitlab.example.com:web/project.git @docs: https://docs.example.com/project/v2 -->
要点：
- 用
@key:命名约定，避免自由文本（方便 IDE 插件提取） - 只写团队/系统级标识，不写个人联系方式
- URL 必须是内部可访问的文档或代码仓库地址，而非本地路径或临时链接
- 禁止包含手机号、私人邮箱、即时通讯 ID
构建流程中自动注入比手写注释更靠谱
手写注释容易遗漏、过期、格式混乱。现代前端工程更倾向在构建时注入元信息。例如 Vite 项目可在 vite.config.ts 中配置：
export default defineConfig({
define: {
__AUTHOR__: JSON.stringify('frontend-team'),
__BUILD_TIME__: JSON.stringify(new Date().toISOString()),
},
})然后在 JS 中读取：console.log(__AUTHOR__, __BUILD_TIME__)；或通过插件写入 HTML 的 <meta> 标签。这种方式保证每次部署信息一致，且不污染源码注释区。
真正关键的不是“怎么写”，而是“谁会看、怎么看、怎么用”。开发者查联系方式，第一反应是翻 package.json 的 author 字段或仓库首页，而不是打开浏览器右键“查看页面源代码”去搜 <!--。
