问题标签 [naming-conventions]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票
9 回答
4541 浏览

.net - 属性“ID”的正确命名约定是什么:ID 或 Id?

非常简单的问题:当我有一个可持久对象时,它通常有一个名为 ID 的属性(用于抽象类)。

那么..是命名约定ID还是Id?

例如。

或者

干杯:)

PS。这是.NET顺便说一句。FXCop 配置将是一个奖励。

0 投票
6 回答
34268 浏览

c# - C# Float vs. VB.net Single - Namin'抱怨'

为什么它在 VB.net 中被称为单曲?我确信这是有充分理由的,但对于像我这样未经正式培训的程序员来说,这似乎并不直观。

0 投票
7 回答
650121 浏览

git - 命名 git 分支的常用做法有哪些示例?

几个月来,我一直在使用本地 git 存储库与我小组的 CVS 存储库进行交互。我已经制作了几乎神经质的分支,谢天谢地,其中大部分已经合并回我的树干。但是命名开始成为一个问题。如果我有一个任务很容易用一个简单的标签命名,但我分三个阶段完成,每个阶段都包括自己的分支和合并情况,那么我可以每次都重复分支名称,但这会使历史有点混乱。如果我的名称更具体,每个阶段都有单独的描述,那么分支名称开始变得冗长而笨拙。

我确实在这里学习了查看旧线程,我可以开始使用名称中的 / 来命名分支,即主题/任务或类似的东西。我可能会开始这样做,看看它是否有助于更好地组织事情。

命名 git 分支的最佳实践是什么?

编辑:实际上没有人建议任何命名约定。当我完成它们时,我会删除它们。由于管理层不断调整我的优先级,我碰巧有几个。:) 作为一个示例,为什么我可能需要在一个任务上使用多个分支,假设我需要将任务中的第一个离散里程碑提交到组的 CVS 存储库。那时,由于我与 CVS 的交互不完善,我将执行该提交,然后终止该分支。(如果我尝试在那时继续使用相同的分支,我已经看到了与 CVS 交互的太多奇怪之处。)

0 投票
5 回答
1612 浏览

naming-conventions - 何时将网站视为“静态”或“动态”

我创建了一个站点,它解析 XML 文件并在适当的页面上显示其内容。我的网站是动态网页还是静态网页?

动态网页和静态网页有何不同?

我觉得它是动态的,因为我从 xml 文件中解析内容;最初我的主页中没有任何内容..

对此你怎么看,请解释一下。。

0 投票
4 回答
1390 浏览

coding-style - 文件名的定义?

经过多年的编程,仍然有一些简单的事情让我感到困惑。

是否有普遍认可的文件名定义?

甚至维基百科的文章也混淆了这两种解释。

它首先将其定义为“一种特殊的字符串,用于唯一标识存储在计算机文件系统上的文件”。这似乎很清楚,并表明文件名是完全限定的文件名,指定文件的完整路径。

然而,它接着是:

  • 谈论基本名称和扩展名(所以基本名称将包含绝对路径?)
  • 说DOS中文件名的长度限制为8.3
  • 表示没有路径部分的文件名被假定为当前工作目录中的文件(因此文件名不能唯一标识文件)

所以,简单的问题:

  • 什么是“文件名”的正确定义(包括参考)
  • 我应该如何明确地命名变量:
    • 文件的路径(可以是绝对/完整或相对)
    • 可以是文件/目录/套接字的资源的路径
0 投票
3 回答
1658 浏览

database - 命名数据库中的中间表

考虑两个表事务和类别,每个表都有自己的 ID 和信息。

一个事务可以有多个类别,我已经阅读过创建第三个表以使用它们的 ID 链接事务和类别是最好的。但是,假设您有很多人喜欢它,您会怎么称呼这张桌子?

transactionCategories 是我想出的最好的,还有更好的吗?

0 投票
20 回答
1082 浏览

variables - 您是否遵循原始程序员的命名约定?

如果你从某人那里接手一个项目来做简单的更新,你会遵循他们的命名约定吗?我刚收到一个项目,以前的程序员到处使用匈牙利符号。我们的核心产品有一个命名标准,但多年来我们有很多人做自定义报告,做他们想做的任何事情。

不过,我没有时间更改代码中已经存在的所有变量名称。

我倾向于继续他们的命名约定以保持可读性。

0 投票
4 回答
238 浏览

data-structures - 集合中“查找、删除和返回元素”的术语?

标题主要说明了这一点。我想在 C# 中向基本 Dictionary 类添加一个简单的扩展方法。起初我打算将它命名为 Pop(TKey key),有点像 Stack 方法,但它接受一个用于查找的键。

然后我打算做Take(TKey key),但是它与同名的LINQ方法不谋而合……虽然C# 3.0可以让你这样做,但我不喜欢它。

那么,您认为,只是坚持使用 Pop 还是“查找并删除元素”有更好的术语?

(我觉得问这个问题有点尴尬,这似乎是一件微不足道的事情......但我喜欢使用标准,而且我对许多语言/环境没有丰富的经验。)

编辑:对不起,应该解释更多......在这种情况下,我不能使用术语删除,因为它已经由我使用新方法扩展的类定义。

编辑 2:好的,这就是我到目前为止所拥有的,受到群众智慧的启发:

0 投票
12 回答
87189 浏览

java - 您在 Java 中为个人/爱好项目使用什么包命名约定?

我已经熟悉使用域名创建唯一包名(即 package com.stackoverflow.widgets)的标准 Java 包命名约定。但是,我从未见过任何关于如何为个人项目选择包名的建议。我认为这是因为这确实是个人品味的问题。

那么,您如何为永远不会投入生产的个人项目选择包名称(您可能会在业余时间尝试新框架)。假设您没有可以使用其域来创建包结构的个人网站,您会(或会)做什么?你是否有一个逻辑系统来为爱好项目生成新的包名,或者你只是使用简单的一次性包名,比如mypackage

因为我只是想看看不同的人对此有什么想法,所以我把它做成了一个社区维基。

就我个人而言,我从来没有考虑过太多,但我今晚想和Wicket一起玩,我突然想到我并不清楚我想如何组织我的爱好项目。为爱好项目(至少在我看来)一个单独的、不同的包命名约定将作为一种很好的方式来保持个人和工作相关的代码彼此清楚地分开。

我正在考虑一个简单的分层命名约定,将我的个人项目的源代码保存在一个根文件夹中:

  • myprojects用作根文件夹
  • 附加项目名称
  • 添加任何其他子包名称

因此,我的 Wicket 项目将在包中myprojects.learningwicket,而单元测试将在包中myprojects.learningwicket.tests(例如)。

0 投票
9 回答
409 浏览

java - 持有具有起始时间的对象的类的好名字

我正在创建一个(Java)类来表示乐谱中具有特定开始时间的对象,并且可能还有持续时间。我需要为这门课起个好听的名字。像“Timed”或“TimedObject”这样的东西合适吗?我试图想出一些以“-able”结尾的东西(比如 Runnable),但我想不出什么好东西;“OnsetTimeable”听起来很傻,因为“OnsetTime”不是动词。我也不太喜欢“MusicalObject”,因为这并不意味着该对象有一个开始时间(“音乐对象”可以是与乐谱相关的任何东西)。

更新:从音乐上讲,这个类代表了乐谱中某个时间点发生的事情的抽象。这应该是 Note、KeyChange、MeterChange、DynamicMarking、TempoMark 等类的超类。